clear_matrixT_clear_matrixClearMatrixClearMatrixclear_matrix清除矩阵（算子）
名称
clear_matrixT_clear_matrixClearMatrixClearMatrixclear_matrix — 释放矩阵的内存。
签名
Herror T_clear_matrix(const Htuple MatrixID)
def clear_matrix(matrix_id: MaybeSequence[HHandle]) -> None
描述
算子 clear_matrixclear_matrixClearMatrixClearMatrixClearMatrixclear_matrix 释放由矩阵句柄 MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id 指定的矩阵 Matrix 的内存。调用 clear_matrixclear_matrixClearMatrixClearMatrixClearMatrixclear_matrix后，该 Matrix 将无法继续使用。矩阵句柄 MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id 将失效。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子修改后续输入参数的状态：
在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。
参数
MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (输入控制，状态被修改) matrix(-array) → HMatrix, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
矩阵句柄。
结果
如果参数有效，算子 clear_matrixclear_matrixClearMatrixClearMatrixClearMatrixclear_matrix 返回值 2 (H_MSG_TRUE)。如有必要，则抛出异常。
可能的前趋
create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix
模块
基础