ReadCondition Interface Reference
[Read Conditions]

<<interface>> Conditions specifically dedicated to read operations and attached to one com.rti.dds.subscription.DataReader. More...

Inheritance diagram for ReadCondition:

List of all members.

Public Member Functions
int	get_sample_state_mask ()
	Retrieves the set of sample_states for the condition.
int	get_view_state_mask ()
	Retrieves the set of view_states for the condition.
int	get_instance_state_mask ()
	Retrieves the set of instance_states for the condition.
DataReader	get_datareader ()
	Returns the com.rti.dds.subscription.DataReader associated with the com.rti.dds.subscription.ReadCondition.

---

Detailed Description

<<interface>> Conditions specifically dedicated to read operations and attached to one com.rti.dds.subscription.DataReader.

com.rti.dds.subscription.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 com.rti.dds.topic.example.FooDataReader.read and com.rti.dds.topic.example.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 com.rti.dds.subscription.ReadCondition may be attached to the same com.rti.dds.subscription.DataReader.

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

---

Member Function Documentation

int get_sample_state_mask

(

)

Retrieves the set of sample_states for the condition.

int get_view_state_mask

(

)

Retrieves the set of view_states for the condition.

int get_instance_state_mask

(

)

Retrieves the set of instance_states for the condition.

DataReader get_datareader

(

)

Returns the com.rti.dds.subscription.DataReader associated with the com.rti.dds.subscription.ReadCondition.

There is exactly one com.rti.dds.subscription.DataReader assicated with each com.rti.dds.subscription.ReadCondition.

Returns:

com.rti.dds.subscription.DataReader associated with the com.rti.dds.subscription.ReadCondition.