RTI Connext Traditional C++ API Version 7.3.0

<<interface>> A specific DDSCondition whose trigger_value is completely under the control of the application. More...

Inheritance diagram for DDSGuardCondition:
DDSCondition

Public Member Functions

virtual DDS_Boolean get_trigger_value ()
 Retrieve the trigger_value. More...
 
virtual DDS_ReturnCode_t set_trigger_value (DDS_Boolean value)
 Set the guard condition trigger value. More...
 
 DDSGuardCondition ()
 No argument constructor. More...
 
virtual ~DDSGuardCondition ()
 Destructor. More...
 
- Public Member Functions inherited from DDSCondition
virtual DDS_Boolean get_trigger_value ()=0
 Retrieve the trigger_value. More...
 
virtual DDS_ReturnCode_t set_handler (DDSConditionHandler *handler)
 <<extension>> Registers a DDSConditionHandler in this DDSCondition. More...
 
virtual DDSConditionHandlerget_handler ()
 <<extension>> Returns the registered DDSConditionHandler. More...
 
virtual void dispatch ()
 <<extension>> Calls DDSConditionHandler::on_condition_triggered of the registered DDSConditionHandler. More...
 

Detailed Description

<<interface>> A specific DDSCondition whose trigger_value is completely under the control of the application.

The DDSGuardCondition provides a way for an application to manually wake up a DDSWaitSet. This is accomplished by attaching the DDSGuardCondition to the DDSWaitSet and then setting the trigger_value by means of the DDSGuardCondition::set_trigger_value operation.

See also
DDSWaitSet

Constructor & Destructor Documentation

◆ DDSGuardCondition()

DDSGuardCondition::DDSGuardCondition ( )

No argument constructor.

The default constructor initializes the guard condition with trigger value DDS_BOOLEAN_FALSE

◆ ~DDSGuardCondition()

virtual DDSGuardCondition::~DDSGuardCondition ( )
virtual

Destructor.

Releases the resources associated with this object.

MT Safety:
UNSAFE. In VxWorks, it is unsafe to call this method while another thread may be simultaneously calling DDSDomainParticipantFactory::get_instance, DDSDomainParticipantFactory::finalize_instance, DDS_TypeCodeFactory::get_instance, DDSGuardCondition::DDSGuardCondition, DDSWaitSet::DDSWaitSet(), DDSWaitSet::DDSWaitSet(const DDS_WaitSetProperty_t&), DDSGuardCondition::~DDSGuardCondition, DDSWaitSet::~DDSWaitSet(), NDDSUtilityNetworkCapture::enable, or NDDSUtilityNetworkCapture::disable.

Deleting a NULL condition is safe and has no effect.

Member Function Documentation

◆ get_trigger_value()

virtual DDS_Boolean DDSGuardCondition::get_trigger_value ( )
virtual

Retrieve the trigger_value.

Returns
the trigger value.

Implements DDSCondition.

◆ set_trigger_value()

virtual DDS_ReturnCode_t DDSGuardCondition::set_trigger_value ( DDS_Boolean  value)
virtual

Set the guard condition trigger value.

Parameters
value<<in>> the new trigger value.