RTI Connext Modern C++ API  Version 6.0.1
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
dds::sub::status::InstanceState Class Reference

Indicates if the samples are from a live dds::pub::DataWriter or not. More...

#include <dds/sub/status/DataState.hpp>

Inherits bitset< OMG_DDS_STATE_BIT_COUNT >.

Public Types

typedef std::bitset
< OMG_DDS_STATE_BIT_COUNT > 
MaskType
 An std::bitset of InstanceStates.
 

Public Member Functions

 InstanceState (const MaskType &other)
 Create an InstanceState from MaskType.
 

Static Public Member Functions

static const InstanceState alive ()
 Creates an alive InstanceState object.
 
static const InstanceState not_alive_disposed ()
 Creates a not_alive_disposed InstanceState object.
 
static const InstanceState not_alive_no_writers ()
 Creates a not_alive_no_writers InstanceState object.
 
static const InstanceState not_alive_mask ()
 Creates an InstanceState object representing any not alive states (not_alive_disposed() | not_alive_no_writers())
 
static const InstanceState any ()
 Creates an InstanceState object representing any instance states (not_alive_disposed() | not_alive_no_writers() | alive())
 

Detailed Description

Indicates if the samples are from a live dds::pub::DataWriter or not.

For each instance, the middleware internally maintains an instance state. The instance state can be:

The precise behavior events that cause the instance state to change depends on the setting of the OWNERSHIP QoS:

The instance state available in the dds::sub::SampleInfo is a snapshot of the instance state of the instance at the time the collection was obtained (i.e. at the time read or take was called). The instance state is therefore the same for all samples in the returned collection that refer to the same instance.

Member Typedef Documentation

typedef std::bitset<OMG_DDS_STATE_BIT_COUNT > dds::sub::status::InstanceState::MaskType

An std::bitset of InstanceStates.

Constructor & Destructor Documentation

dds::sub::status::InstanceState::InstanceState ( const MaskType other)
inline

Create an InstanceState from MaskType.

Parameters
otherThe MaskType to create the InstanceState with

Member Function Documentation

static const InstanceState dds::sub::status::InstanceState::alive ( )
inlinestatic

Creates an alive InstanceState object.

The instance is currently in existence.

static const InstanceState dds::sub::status::InstanceState::not_alive_disposed ( )
inlinestatic

Creates a not_alive_disposed InstanceState object.

The instance has been disposed by a DataWriter.

static const InstanceState dds::sub::status::InstanceState::not_alive_no_writers ( )
inlinestatic

Creates a not_alive_no_writers InstanceState object.

None of the DataWriters that are currently alive (according to the dds::core::policy::Liveliness policy) are writing the instance.

static const InstanceState dds::sub::status::InstanceState::not_alive_mask ( )
inlinestatic

Creates an InstanceState object representing any not alive states (not_alive_disposed() | not_alive_no_writers())

static const InstanceState dds::sub::status::InstanceState::any ( )
inlinestatic

Creates an InstanceState object representing any instance states (not_alive_disposed() | not_alive_no_writers() | alive())


RTI Connext Modern C++ API Version 6.0.1 Copyright © Sat Nov 23 2019 Real-Time Innovations, Inc