20.1.1.3. Entity

class Entity

The Entity class is the abstract base class for all the objects that support QoS policies, a listener and a status condition.

Subclassed by eprosima::fastdds::dds::DomainEntity, eprosima::fastdds::dds::DomainParticipant

Public Functions

inline Entity(const StatusMask &mask = StatusMask::all())

Constructor.

Parameters:

mask – StatusMask (default: all)

inline virtual ReturnCode_t enable()

This operation enables the Entity.

Returns:

RETCODE_OK

inline void close()

This operation disables the Entity before closing it.

inline const StatusMask &get_status_mask() const

Retrieves the set of relevant statuses for the Entity.

Returns:

Reference to the StatusMask with the relevant statuses set to 1

const StatusMask &get_status_changes() const

Retrieves the set of triggered statuses in the Entity.

Triggered statuses are the ones whose value has changed since the last time the application read the status. When the entity is first created or if the entity is not enabled, all communication statuses are in the non-triggered state, so the list returned by the get_status_changes operation will be empty. The list of statuses returned by the get_status_changes operation refers to the status that are triggered on the Entity itself and does not include statuses that apply to contained entities.

Returns:

const reference to the StatusMask with the triggered statuses set to 1

inline const InstanceHandle_t &get_instance_handle() const

Retrieves the instance handler that represents the Entity.

Returns:

Reference to the InstanceHandle

inline bool is_enabled() const

Checks if the Entity is enabled.

Returns:

true if enabled, false if not

inline StatusCondition &get_statuscondition()

Allows access to the StatusCondition associated with the Entity.

Returns:

Reference to StatusCondition object

inline const StatusCondition &get_statuscondition() const

Allows access to the StatusCondition associated with the Entity.

Returns:

Const Reference to StatusCondition object