RTI Connext C API  Version 5.0.0
Read Conditions

DDS_ReadCondition and associated elements More...

Typedefs

typedef struct
DDS_ReadConditionImpl 
DDS_ReadCondition
 <<interface>> Conditions specifically dedicated to read operations and attached to one DDS_DataReader.
 

Functions

DDS_ConditionDDS_ReadCondition_as_condition (DDS_ReadCondition *read_condition)
 Accesses a DDS_ReadCondition's supertype instance.
 
DDS_SampleStateMask DDS_ReadCondition_get_sample_state_mask (DDS_ReadCondition *self)
 Retrieves the set of sample_states for the condition.
 
DDS_ViewStateMask DDS_ReadCondition_get_view_state_mask (DDS_ReadCondition *self)
 Retrieves the set of view_states for the condition.
 
DDS_InstanceStateMask DDS_ReadCondition_get_instance_state_mask (DDS_ReadCondition *self)
 Retrieves the set of instance_states for the condition.
 
DDS_DataReaderDDS_ReadCondition_get_datareader (DDS_ReadCondition *self)
 Returns the DDS_DataReader associated with the DDS_ReadCondition.
 

Detailed Description

DDS_ReadCondition and associated elements

Typedef Documentation

typedef struct DDS_ReadConditionImpl DDS_ReadCondition

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

DDS_ReadCondition 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 DDS_ReadCondition may be attached to the same DDS_DataReader.

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

Function Documentation

DDS_Condition* DDS_ReadCondition_as_condition ( DDS_ReadCondition read_condition)

Accesses a DDS_ReadCondition's supertype instance.

Parameters
read_condition<<in>> Cannot be NULL.
DDS_SampleStateMask DDS_ReadCondition_get_sample_state_mask ( DDS_ReadCondition self)

Retrieves the set of sample_states for the condition.

Parameters
self<<in>> Cannot be NULL.
DDS_ViewStateMask DDS_ReadCondition_get_view_state_mask ( DDS_ReadCondition self)

Retrieves the set of view_states for the condition.

Parameters
self<<in>> Cannot be NULL.
DDS_InstanceStateMask DDS_ReadCondition_get_instance_state_mask ( DDS_ReadCondition self)

Retrieves the set of instance_states for the condition.

Parameters
self<<in>> Cannot be NULL.
DDS_DataReader* DDS_ReadCondition_get_datareader ( DDS_ReadCondition self)

Returns the DDS_DataReader associated with the DDS_ReadCondition.

There is exactly one DDS_DataReader assicated with each DDS_ReadCondition.

Parameters
self<<in>> Cannot be NULL.
Returns
DDS_DataReader associated with the DDS_ReadCondition.

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