clear_barrierT_clear_barrierClearBarrierClearBarrier (Operator)

Name

clear_barrierT_clear_barrierClearBarrierClearBarrier — Destroy a barrier synchronization object.

Signature

Description

clear_barrierclear_barrierClearBarrierClearBarrierClearBarrier destroys the barrier object given in BarrierHandleBarrierHandleBarrierHandleBarrierHandlebarrierHandle. No threads should be waiting on the barrier at the time clear_barrierclear_barrierClearBarrierClearBarrierClearBarrier is called. After calling clear_barrierclear_barrierClearBarrierClearBarrierClearBarrier, the barrier can no longer be used. The handle BarrierHandleBarrierHandleBarrierHandleBarrierHandlebarrierHandle becomes invalid.

Execution Information

• Multithreading type: independent (runs in parallel even with exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator modifies the state of the following input parameter:

• BarrierHandleBarrierHandleBarrierHandleBarrierHandlebarrierHandle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

Result

If the barrier handle is valid, the operator clear_barrierclear_barrierClearBarrierClearBarrierClearBarrier returns 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_barriercreate_barrierCreateBarrierCreateBarrierCreateBarrier

See also

create_barriercreate_barrierCreateBarrierCreateBarrierCreateBarrier

Module

Foundation