clear_handle — Clear the content of a handle.
clear_handle( : : Handle : )
clear_handle clears the content of the handle contained in
The handle is left in a cleared state afterwards. Attempts to use it
in any other operator will raise an error.
Usually, handles are automatically cleared once all references in
all tuples are overwritten.
clear_handle can be used to clear a handle at a specific
time, even if there are still references to it.
This operator can be used to clear handles of any type instead of the more
specialized operators, such as
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Handle(input_control, state is modified) tuple(-array)
Handle to clear.
If the parameters are valid, the operator
returns the value TRUE. Otherwise, an exception is raised.