clear_handleT_clear_handleClearHandleClearHandleclear_handle (算子)

名称

clear_handleT_clear_handleClearHandleClearHandleclear_handle — 清除句柄的内容。

签名

描述

clear_handleclear_handleClearHandleClearHandleClearHandleclear_handle clears the content of the handle contained in HandleHandleHandleHandlehandlehandle. 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_handleclear_handleClearHandleClearHandleClearHandleclear_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_matrixclear_matrixClearMatrixClearMatrixClearMatrixclear_matrix or clear_shape_modelclear_shape_modelClearShapeModelClearShapeModelClearShapeModelclear_shape_model。

执行信息

• 多线程类型：独立（即使使用独占算子也能并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

此算子修改后续输入参数的状态：

• HandleHandleHandleHandlehandlehandle

在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。

参数

结果

如果参数有效，算子 clear_handleclear_handleClearHandleClearHandleClearHandleclear_handle 返回值 2 ( H_MSG_TRUE )。否则，将抛出异常。

另见

tuple_is_valid_handletuple_is_valid_handleTupleIsValidHandleTupleIsValidHandleTupleIsValidHandletuple_is_valid_handle

模块

基础