GuardCondition Class Reference

<<interface>> A specific com.rti.dds.infrastructure.Condition whose trigger_value is completely under the control of the application. More...

Inherits AbstractNativeObject, and NativeCondition.

Public Member Functions
	GuardCondition ()
	No argument constructor. More...
void	set_trigger_value (boolean value)
	Set the guard condition trigger value. More...
boolean	get_trigger_value ()
	Retrieve the trigger_value. More...
void	delete ()
	Destructor. More...

Detailed Description

<<interface>> A specific com.rti.dds.infrastructure.Condition whose trigger_value is completely under the control of the application.

The com.rti.dds.infrastructure.GuardCondition provides a way for an application to manually wake up a com.rti.dds.infrastructure.WaitSet. This is accomplished by attaching the com.rti.dds.infrastructure.GuardCondition to the com.rti.dds.infrastructure.WaitSet and then setting the trigger_value by means of the com.rti.dds.infrastructure.GuardCondition.set_trigger_value operation.

Important: The com.rti.dds.infrastructure.GuardCondition allocates native resources. When com.rti.dds.infrastructure.GuardCondition is no longer being used, user should call com.rti.dds.infrastructure.GuardCondition.delete explicitly to properly cleanup all native resources.

See also

com.rti.dds.infrastructure.WaitSet

Constructor & Destructor Documentation

GuardCondition()

GuardCondition

(

)

No argument constructor.

Construct a new guard condition with trigger value com.rti.dds.infrastructure.false.

Exceptions

com.rti.dds.infrastructure.RETCODE_OUT_OF_RESOURCES

if a new com.rti.dds.infrastructure.GuardCondition could not be allocated.

Important: The com.rti.dds.infrastructure.GuardCondition allocates native resources. When com.rti.dds.infrastructure.GuardCondition is no longer being used, user should call com.rti.dds.infrastructure.GuardCondition.delete explicitly to properly cleanup all native resources.

Member Function Documentation

set_trigger_value()

void set_trigger_value

(

boolean

value

)

Set the guard condition trigger value.

Parameters

value

<<in>> the new trigger value.

get_trigger_value()

boolean get_trigger_value

(

)

Retrieve the trigger_value.

Returns

the trigger value.

Implements Condition.

delete()

void delete

(

)

Destructor.

Releases the resources associated with this object.

Calling this method multiple times on the same object is safe; subsequent deletions will have no effect.