| DDS-PSM-C++ 1.0 ISO C++ API for OpenSplice DDS |
| DDS-PSM-C++ 1.0 ISO C++ API for OpenSplice DDS |
#include <TEntity.hpp>
Public Member Functions | |
| ~TEntity () | |
| void | close () |
| void | enable () |
| const dds::core::InstanceHandle | instance_handle () const |
| void | retain () |
| const dds::core::status::StatusMask | status_changes () |
 Public Member Functions inherited from dds::core::Reference< DELEGATE > | |
| Reference (dds::core::null_type &) | |
| Reference (const Reference &ref) | |
| template<typename D > | |
| Reference (const Reference< D > &ref) | |
| Reference (DELEGATE_T *p) | |
| ~Reference () | |
| const DELEGATE_REF_T & | delegate () const |
| DELEGATE_REF_T & | delegate () |
| bool | is_nil () const |
| operator const DELEGATE_REF_T & () const | |
| operator DELEGATE_REF_T () const | |
| operator DELEGATE_REF_T & () | |
| template<typename R > | |
| bool | operator!= (const R &ref) const |
| bool | operator!= (const null_type nil) const |
| DELEGATE * | operator-> () |
| const DELEGATE * | operator-> () const |
| template<typename D > | |
| Reference & | operator= (const Reference< D > &that) |
| template<typename R > | |
| Reference & | operator= (const R &rhs) |
| Reference & | operator= (const null_type) |
| template<typename R > | |
| bool | operator== (const R &ref) const |
| bool | operator== (const null_type) const |
Additional Inherited Members | |
| Protected Attributes inherited from dds::core::Reference< DELEGATE > | |
| DELEGATE_REF_T | impl_ |
This class is the abstract base class for all the DCPS objects that support QoS policies, a listener and a status condition. In the ISO C++ PSM each DDS entity behaves like a polymorphic reference in what it automatically manages its resource and it can be safely assigned up and down the DDS Entity type hierarchy.
Definition at line 40 of file TEntity.hpp.
| dds::core::TEntity< DELEGATE >::~TEntity | ( | ) |
| void dds::core::TEntity< DELEGATE >::close | ( | ) |
This method closes the entity and releases all resources associated with DDS, such as threads, sockets, buffers, etc. Any attempt to invoke methods on a closed entity will raise an exception.
| void dds::core::TEntity< DELEGATE >::enable | ( | ) |
This operation enables the Entity. Entity objects can be created either enabled or disabled. This is controlled by the value of the ENTITY_FACTORY Qos policy (Section 7.1.3.20, ENTITY_FACTORY) on the corresponding factory for the Entity. The default setting of ENTITY_FACTORY is such that, by default, it is not necessary to explicitly call enable on newly created entities (see Section 7.1.3.20, ENTITY_FACTORY). The enable operation is idempotent. Calling enable on an already enabled Entity does nor raise exceptions and has no effect.
Entities created from a factory that is disabled, are created disabled regardless of the setting of the ENTITY_FACTORY Qos policy. Calling enable on an Entity whose factory is not enabled will fail and return PRECONDITION_NOT_MET. If the ENTITY_FACTORY Qos policy has autoenable_created_entities set to TRUE, the enable operation on the factory will automatically enable all entities created from the factory. The Listeners associated with an entity are not called until the entity is enabled. Conditions associated with an entity that is not enabled are inactive, that is, have a trigger_value==FALSE (see Section 7.1.4.4, “Conditions and Wait-sets, on page 131).
| const dds::core::InstanceHandle dds::core::TEntity< DELEGATE >::instance_handle | ( | ) | const |
This operation returns the InstanceHandle_t that represents the Entity.
| void dds::core::TEntity< DELEGATE >::retain | ( | ) |
Indicates that references to this object may go out of scope but that the application expects to look it up again later. Therefore, the Service must consider this object to be still in use and may not close it automatically.
| const dds::core::status::StatusMask dds::core::TEntity< DELEGATE >::status_changes | ( | ) |
This operation retrieves the list of communication statuses in the Entity that are triggered.That is, the list of statuses whose value has changed since the last time the application read the status. The precise definition of the triggered state of communication statuses is given in Section 7.1.4.2, Changes in Status, on page 126. When the entity is first created or if the entity is not enabled, all communication statuses are in the untriggered state so the list returned by the status_changes operation will be empty. The list of statuses returned by the status_changes operation refers to the statuses that are triggered on the Entity itself and does not include statuses that apply to contained entities.
1.8.2 
