dds::topic::TopicDescription Class Reference

This class is the base for Topic, ContentFilteredTopic and MultiTopic. More...

#include "TopicDescription.hpp"

Inherits dds::core::Reference< DELEGATE >.

Inherited by dds::topic::AnyTopic, and dds::topic::ContentFilteredTopic< T >.

Public Member Functions
const dds::domain::DomainParticipant &	domain_participant () const
bool	is_nil () const
const std::string &	name () const
bool	operator!= (const null_type nil) const
template<typename R >
bool	operator!= (const R &ref) const
DELEGATE *	operator-> ()
const DELEGATE *	operator-> () const
bool	operator== (const null_type) const
template<typename R >
bool	operator== (const R &ref) const
const std::string &	type_name () const

Detailed Description

This class is the base for Topic, ContentFilteredTopic and MultiTopic.

The TopicDescription attribute type_name defines an unique data type that is made available to the Data Distribution Service when a Topic is created with that type.
TopicDescription has also a name that allows it to be retrieved locally.

See also

Topic Definition

Definition at line 48 of file TopicDescription.hpp.

Member Function Documentation

domain_participant()

const dds::domain::DomainParticipant& dds::topic::TopicDescription::domain_participant

(

)

const

This operation returns the DomainParticipant associated with the TopicDescription.

Note that there is exactly one DomainParticipant associated with each TopicDescription.

Returns

the DomainParticipant

is_nil()

template<typename DELEGATE>

bool dds::core::Reference< DELEGATE >::is_nil ( ) const

inherited

Check if the referenced object is nil.

In other words, check if the reference is pointing to a null object.

Returns

true if the referenced object is null.

name()

const std::string& dds::topic::TopicDescription::name

(

)

const

This operation returns the name used to create the TopicDescription.

Returns

the TopicDescription name

operator!=() [1/2]

template<typename DELEGATE>

bool dds::core::Reference< DELEGATE >::operator!= ( const null_type  nil ) const

inherited

Special operator!= used to check if this reference object does not equal the dds::core::null reference.

The non-null-check can be done like this:

if (r != dds::core::null) {
   // Use the dds reference object r
}

Returns

true if this reference is not null.

operator!=() [2/2]

template<typename DELEGATE>

template<typename R >

bool dds::core::Reference< DELEGATE >::operator!= ( const R &  ref ) const

inherited

Compares two Reference objects and returns true if they are not equal.

Inequality is based on the referential inequality of the object being pointed to.

Parameters

ref	the other Reference object

Returns

true when not equal

operator->() [1/2]

template<typename DELEGATE>

DELEGATE* dds::core::Reference< DELEGATE >::operator-> ( )

inherited

The operator->() is provided to be able to directly invoke functions on the delegate.

The decision to provide direct access to the delegate was motivated by the need for providing a way that was not invasive with respect to the CXXDDS API and yet would allow for vendor-specific extension. Thus vendor-specific extensions can be invoked on the Reference and on all its subclasses as follows:

my_dds_entity.standard_function();
my_dds_entity->vendor_specific_extension();

Returns

a reference to delegate.

operator->() [2/2]

template<typename DELEGATE>

const DELEGATE* dds::core::Reference< DELEGATE >::operator-> ( ) const

inherited

The operator->() is provided to be able to directly invoke functions on the delegate.

The decision to provide direct access to the delegate was motivated by the need for providing a way that was not invasive with respect to the CXXDDS API and yet would allow for vendor-specific extension. Thus vendor-specific extensions can be invoked on the Reference and on all its subclasses as follows:

my_dds_entity.standard_function();
my_dds_entity->vendor_specific_extension();

Returns

a reference to delegate.

operator==() [1/2]

template<typename DELEGATE>

bool dds::core::Reference< DELEGATE >::operator== ( const  null_type ) const

inherited

Special operator== used to check if this reference object equals the dds::core::null reference.

The null-check can be done like this:

if (r == dds::core::null) {
   // Do not use the dds reference object r in its current state
}

Returns

true if this reference is null.

operator==() [2/2]

template<typename DELEGATE>

template<typename R >

bool dds::core::Reference< DELEGATE >::operator== ( const R &  ref ) const

inherited

Compares two Reference objects and returns true if they are equal.

Equality is based on the referential equality of the object being pointed.

Parameters

ref	the other Reference object

Returns

true when equal

type_name()

const std::string& dds::topic::TopicDescription::type_name

(

)

const

This operation returns the registered name of the data type associated with the TopicDescription.

Returns

the type_name

---

The documentation for this class was generated from the following file:

• dds/topic/TopicDescription.hpp