RTI Connext C++ API  Version 5.0.0
DDSReadCondition Class Referenceabstract

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

Inheritance diagram for DDSReadCondition:
DDSCondition DDSQueryCondition

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.
 
- Public Member Functions inherited from DDSCondition
virtual DDS_Boolean get_trigger_value ()=0
 Retrieve the trigger_value.
 

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.

RTI Connext C++ API Version 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc