RTI Connext .NET API (legacy)  Version 6.1.2

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 DataWriterQosDDS::Publisher::DATAWRITER_QOS_DEFAULT [get]
 Special value for creating DDS::DataWriter with default QoS. More...
 
static DataWriterQosDDS::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 DataWriterQosDDS::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