DDSReadCondition Class Reference
[Read Conditions]

<<interface>> Conditions specifically dedicated to read operations and attached to one DDSDataReader. More...

Inheritance diagram for DDSReadCondition:

List of all members.

Public Member Functions
virtual DDS_SampleStateMask	get_sample_state_mask ()=0
	Retrieves the set of sample_states for the condition.
virtual DDS_ViewStateMask	get_view_state_mask ()=0
	Retrieves the set of view_states for the condition.
virtual DDS_InstanceStateMask	get_instance_state_mask ()=0
	Retrieves the set of instance_states for the condition.
virtual DDSDataReader *	get_datareader ()=0
	Returns the DDSDataReader associated with the DDSReadCondition.

---

Detailed Description

<<interface>> Conditions specifically dedicated to read operations and attached to one DDSDataReader.

DDSReadCondition objects allow an application to specify the data samples it is interested in (by specifying the desired sample_states, view_states as well as instance_states in FooDataReader::read and FooDataReader::take variants.

This allows RTI Connext to enable the condition only when suitable information is available. They are to be used in conjunction with a WaitSet as normal conditions.

More than one DDSReadCondition may be attached to the same DDSDataReader.

Note: If you are using a ReadCondition simply to detect the presence of new data, consider using a DDSStatusCondition with the DATA_AVAILABLE_STATUS instead, which will perform better in this situation.

---

Member Function Documentation

virtual DDS_SampleStateMask DDSReadCondition::get_sample_state_mask

(

)

[pure virtual]

Retrieves the set of sample_states for the condition.

virtual DDS_ViewStateMask DDSReadCondition::get_view_state_mask

(

)

[pure virtual]

Retrieves the set of view_states for the condition.

virtual DDS_InstanceStateMask DDSReadCondition::get_instance_state_mask

(

)

[pure virtual]

Retrieves the set of instance_states for the condition.

virtual DDSDataReader* DDSReadCondition::get_datareader

(

)

[pure virtual]

Returns the DDSDataReader associated with the DDSReadCondition.

There is exactly one DDSDataReader assicated with each DDSReadCondition.

Returns:

DDSDataReader associated with the DDSReadCondition.