DDSReadCondition Class Reference
[Read Conditions]

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

Inheritance diagram for DDSReadCondition:

DDSCondition DDSQueryCondition

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 DDSDataReaderget_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 Data Distribution Service 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.


RTI Data Distribution Service C++ API Version 4.5e Copyright © 23 Oct 2011 Real-Time Innovations, Inc