serialize_matrixT_serialize_matrixSerializeMatrixSerializeMatrixserialize_matrix (Operator)
Name
serialize_matrixT_serialize_matrixSerializeMatrixSerializeMatrixserialize_matrix — Serialize a matrix.
Signature
def serialize_matrix(matrix_id: HHandle) -> HHandle
Description
serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix serializes the data of a matrix (see
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic
principle of serialization). The same data that is written in a
file by write_matrixwrite_matrixWriteMatrixWriteMatrixwrite_matrix is converted to a serialized item.
The matrix is defined by the handle MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. The
serialized matrix is returned by the handle
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by
deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control) matrix → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Matrix handle.
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
Result
If the parameters are valid, the operator
serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
Possible Predecessors
create_matrixcreate_matrixCreateMatrixCreateMatrixcreate_matrix
Possible Successors
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item,
send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item,
deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix
Module
Foundation