connext::WriteSampleRef< T > Class Template Reference

A reference to a data sample for writing. More...

Public Member Functions
	WriteSampleRef ()
	Creates an object with no data. More...
	WriteSampleRef (T &data, WriteParams_t &wparams)
	Creates an object with a reference to a data object. More...
	WriteSampleRef (WriteSample< T > &ws)
	Copies the references to data and params. More...
T &	data () const
	Gets the data this sample contains. More...
WriteParams_t &	info () const
	Gets the write parameters. More...
void	set_data (T &data)
	Sets a reference to the data to be written. More...
void	set_info (WriteParams_t &info)
	Copies the new parameters, overwriting the existing ones More...
bool	is_nil_data () const
	Indicates if this WriteSampleRef contains a reference to data or not. More...
SampleIdentity_t	identity () const
	Gets the identity of this sample. More...

Detailed Description

template<typename T>
class connext::WriteSampleRef< T >

A reference to a data sample for writing.

A WriteSampleRef can be used much like a connext::WriteSample, but it's different in that it holds references to data and write parameters, which need to be explicitly set to existing objects, whereas WriteSample is a value type and it owns its data and info.

Template Parameters

T	The data type that this sample can contain

Constructor & Destructor Documentation

WriteSampleRef() [1/3]

template<typename T >

connext::WriteSampleRef< T >::WriteSampleRef ( )

inline

Creates an object with no data.

See also

set_data

WriteSampleRef() [2/3]

template<typename T >

connext::WriteSampleRef< T >::WriteSampleRef ( T &  data, WriteParams_t &  wparams  )

inline

Creates an object with a reference to a data object.

See also

set_data

WriteSampleRef() [3/3]

template<typename T >

connext::WriteSampleRef< T >::WriteSampleRef ( WriteSample< T > &  ws )

inline

Copies the references to data and params.

After this operation, this object contains a reference to the same data and WriteParams instances as the source.

Member Function Documentation

data()

template<typename T >

T & connext::WriteSampleRef< T >::data ( ) const

inline

Gets the data this sample contains.

Precondition

Data must have been set before

See also

set_data

connext::WriteSample::data()

Referenced by connext::WriteSampleRef< T >::set_data().

info()

template<typename T >

WriteParams_t & connext::WriteSampleRef< T >::info ( ) const

inline

Gets the write parameters.

Precondition

The info object must have been set

See also

set_info()

connext::WriteSample::identity()

Referenced by connext::WriteSampleRef< T >::identity(), and connext::WriteSampleRef< T >::set_info().

set_data()

template<typename T >

void connext::WriteSampleRef< T >::set_data ( T &  data )

inline

Sets a reference to the data to be written.

Assigns a reference to the

Parameters

data	The data this sample will hold a reference to

References connext::WriteSampleRef< T >::data().

set_info()

template<typename T >

void connext::WriteSampleRef< T >::set_info ( WriteParams_t &  info )

inline

Copies the new parameters, overwriting the existing ones

References connext::WriteSampleRef< T >::info().

is_nil_data()

template<typename T >

bool connext::WriteSampleRef< T >::is_nil_data ( ) const

inline

Indicates if this WriteSampleRef contains a reference to data or not.

Returns

True if this sample does not contain a reference to data.

See also

data()

set_data

identity()

template<typename T >

SampleIdentity_t connext::WriteSampleRef< T >::identity ( ) const

inline

Gets the identity of this sample.

Precondition

The info object must have been set

See also

set_info()

connext::WriteSample::identity()

References DDS_WriteParams_t::identity, and connext::WriteSampleRef< T >::info().