clear_handleT_clear_handleClearHandleClearHandleclear_handle清除句柄（算子）
名称
clear_handleT_clear_handleClearHandleClearHandleclear_handle — 清除句柄的内容。
签名
Herror T_clear_handle(const Htuple Handle)
void ClearHandle(const HTuple& Handle)
void HTuple::ClearHandle() const
void HHandle::ClearHandle() const
def clear_handle(handle: MaybeSequence[HHandle]) -> None
描述
clear_handleclear_handleClearHandleClearHandleClearHandleclear_handle 用于清除
HandleHandleHandleHandlehandlehandle 中包含的句柄内容。操作后句柄将保持清空状态。若尝试在其他操作符中使用该句柄，将引发错误。
通常情况下，当所有元组中的引用都被覆盖后，句柄会自动清除。即使句柄仍存在引用，clear_handleclear_handleClearHandleClearHandleClearHandleclear_handle 也能在特定时间点清除该句柄。
该算子可用于清除任意类型的句柄，而无需使用更专业的算子，例如
clear_matrixclear_matrixClearMatrixClearMatrixClearMatrixclear_matrix 或 clear_shape_modelclear_shape_modelClearShapeModelClearShapeModelClearShapeModelclear_shape_model。
执行信息
- 多线程类型：独立（即使使用独占算子也能并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子修改后续输入参数的状态：
在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。
参数
HandleHandleHandleHandlehandlehandle (输入控制，状态被修改) tuple(-array) → HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (HHandle) (HHandle) (handle)
清除句柄。
结果
如果参数有效，算子 clear_handleclear_handleClearHandleClearHandleClearHandleclear_handle 返回值 2 (H_MSG_TRUE)。否则，将抛出异常。
另见
tuple_is_valid_handletuple_is_valid_handleTupleIsValidHandleTupleIsValidHandleTupleIsValidHandletuple_is_valid_handle
模块
基础