Subscribers
[Subscription Module]

DDSSubscriber entity and associated elements More...

Classes
class	DDSSubscriberListener
	<<interface>> DDSListener for status about a subscriber. More...
class	DDSSubscriberSeq
	Declares IDL sequence < DDSSubscriber > . More...
class	DDSSubscriber
	<<interface>> A subscriber is the object responsible for actually receiving data from a subscription. More...
struct	DDS_SubscriberQos
	QoS policies supported by a DDSSubscriber entity. More...
Variables
struct DDS_DataReaderQos	DDS_DATAREADER_QOS_DEFAULT
	Special value for creating data reader with default QoS.
struct DDS_DataReaderQos	DDS_DATAREADER_QOS_USE_TOPIC_QOS
	Special value for creating DDSDataReader with a combination of the default DDS_DataReaderQos and the DDS_TopicQos.

---

Detailed Description

DDSSubscriber entity and associated elements

---

Variable Documentation

struct DDS_DataReaderQos DDS_DATAREADER_QOS_DEFAULT

Special value for creating data reader with default QoS.

When used in DDSSubscriber::create_datareader, this special value is used to indicate that the DDSDataReader should be created with the default DDSDataReader QoS by means of the operation get_default_datareader_qos and using the resulting QoS to create the DDSDataReader.

When used in DDSSubscriber::set_default_datareader_qos, this special value is used to indicate that the default QoS should be reset back to the initial value that would be used if the DDSSubscriber::set_default_datareader_qos operation had never been called.

When used in DDSDataReader::set_qos, this special value is used to indicate that the QoS of the DDSDataReader should be changed to match the current defualt QoS set in the DDSSubscriber that the DDSDataReader belongs to.

Note: You cannot use this value to get the default QoS values for a DataReader; for this purpose, use DDSDomainParticipant::get_default_datareader_qos.

See also:

DDSSubscriber::create_datareader

DDSSubscriber::set_default_datareader_qos

DDSDataReader::set_qos

Examples:

HelloWorld_subscriber.cxx.

struct DDS_DataReaderQos DDS_DATAREADER_QOS_USE_TOPIC_QOS

Special value for creating DDSDataReader with a combination of the default DDS_DataReaderQos and the DDS_TopicQos.

The use of this value is equivalent to the application obtaining the default DDS_DataReaderQos and the DDS_TopicQos (by means of the operation DDSTopic::get_qos) and then combining these two QoS using the operation DDSSubscriber::copy_from_topic_qos whereby any policy that is set on the DDS_TopicQos "overrides" the corresponding policy on the default QoS. The resulting QoS is then applied to the creation of the DDSDataReader.

This value should only be used in DDSSubscriber::create_datareader.

See also:

DDSSubscriber::create_datareader

DDSSubscriber::get_default_datareader_qos

DDSTopic::get_qos

DDSSubscriber::copy_from_topic_qos