Publishers

DDS::Publisher entity and associated elements More...

Classes
class	DDS::PublisherQos
	QoS policies supported by a DDS::Publisher entity. More...
class	DDS::PublisherListener
	<<interface>> DDS::Listener for DDS::Publisher status. More...
class	DDS::PublisherSeq
	Declares IDL sequence < DDS::Publisher > . More...
class	DDS::Publisher
	<<interface>> A publisher is the object responsible for the actual dissemination of publications. More...

Functions
bool	DDS::PublisherQos::equals (PublisherQos^ other)
	Compares two DDS::PublisherQos for equality. More...

Properties
static DataWriterQos^	DDS::Publisher::DATAWRITER_QOS_DEFAULT [get]
	Special value for creating DDS::DataWriter with default QoS. More...
static DataWriterQos^	DDS::Publisher::DATAWRITER_QOS_PRINT_ALL [get]
	Special value which can be supplied to DDS::DataWriterQos::ToString(DDS::DataWriterQos^ baseQos, DDS::QosPrintFormat^ format) indicating that all of the QoS should be printed. More...
static DataWriterQos^	DDS::Publisher::DATAWRITER_QOS_USE_TOPIC_QOS [get]
	Special value for creating DDS::DataWriter with a combination of the default DDS::DataWriterQos and the DDS::TopicQos. More...

Detailed Description

DDS::Publisher entity and associated elements

Function Documentation

equals()

bool DDS::PublisherQos::equals

(

PublisherQos^

other

)

Compares two DDS::PublisherQos for equality.

Parameters

other

<<in>> The other PublisherQos to be compared with this PublisherQos.

Returns

true if the two Qos objects are equal or false otherwise.

Properties

DATAWRITER_QOS_DEFAULT

DataWriterQos^ DDS::Publisher::DATAWRITER_QOS_DEFAULT

staticget

Special value for creating DDS::DataWriter with default QoS.

When used in DDS::Publisher::create_datawriter, this special value is used to indicate that the DDS::DataWriter should be created with the default DDS::DataWriter QoS by means of the operation get_default_datawriter_qos and using the resulting QoS to create the DDS::DataWriter.

When used in DDS::Publisher::set_default_datawriter_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 DDS::Publisher::set_default_datawriter_qos operation had never been called.

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

Warning

This value is a constant and should never be modified. You cannot use this value to get the default QoS values for a DataWriter; for this purpose, use DDS::DomainParticipant::get_default_datawriter_qos.

See also

DDS::Publisher::create_datawriter

DDS::Publisher::set_default_datawriter_qos

DDS::DataWriter::set_qos

Examples:

HelloWorld_publisher.cpp, and HelloWorld_publisher.cs.

DATAWRITER_QOS_PRINT_ALL

DataWriterQos^ DDS::Publisher::DATAWRITER_QOS_PRINT_ALL

staticget

Special value which can be supplied to DDS::DataWriterQos::ToString(DDS::DataWriterQos^ baseQos, DDS::QosPrintFormat^ format) indicating that all of the QoS should be printed.

The DDS::DataWriterQos::ToString(DDS::DataWriterQos^ baseQos, DDS::QosPrintFormat^ format) API accepts a base QoS profile as one of its arguments. The resultant string only contains the differences with respect to the supplied base QoS profile. Supplying the DDS::Publisher::DATAWRITER_QOS_PRINT_ALL sentinel value as the base QoS will result in all of the QoS being printed.

Note that there are some QoS policies and fields which are not intended for public use. Even when DDS::Publisher::DATAWRITER_QOS_PRINT_ALL is supplied as the base, these will not be printed unless they differ from the documented default. If you want to see their values, you must use the print_private field within the DDS::QosPrintFormat structure.

This value should only be used as the base parameter to the DDS::DataWriterQos::ToString(DDS::DataWriterQos^ baseQos, DDS::QosPrintFormat^ format) API.

DATAWRITER_QOS_USE_TOPIC_QOS

DataWriterQos^ DDS::Publisher::DATAWRITER_QOS_USE_TOPIC_QOS

staticget

Special value for creating DDS::DataWriter with a combination of the default DDS::DataWriterQos and the DDS::TopicQos.

The use of this value is equivalent to the application obtaining the default DDS::DataWriterQos and the DDS::TopicQos (by means of the operation DDS::Topic::get_qos) and then combining these two QoS using the operation DDS::Publisher::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 DDS::DataWriter.

This value should only be used in DDS::Publisher::create_datawriter.

See also

DDS::Publisher::create_datawriter

DDS::Publisher::get_default_datawriter_qos

DDS::Topic::get_qos

DDS::Publisher::copy_from_topic_qos