clear_handle — Clear the content of a handle.
clear_handle( : : Handle : )
clear_handle clears the content of the handle contained in Handle. 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 clear_matrix or clear_shape_model.
Handle to clear.
If the parameters are valid, the operator clear_handle returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.