serialize_handleT_serialize_handleSerializeHandleSerializeHandleserialize_handle (算子)
名称
serialize_handleT_serialize_handleSerializeHandleSerializeHandleserialize_handle — 序列化句柄的内容。
签名
def serialize_handle(handle: HHandle) -> HHandle
描述
serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle serializes the content of HandleHandleHandleHandlehandlehandle and
returns the serialized item in SerializedItemSerializedItemSerializedItemSerializedItemserializedItemserialized_item
(see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic
principle of serialization).
The serialized item can later be deserialized with
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle。
Note that not all handle types support serialization.
To check if a handle can be serializes, use tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializabletuple_is_serializable
or tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem。Handles that have already been cleared cannot be serialized.
Also note that the serialized item created by this operator is compatible
with the type specific deserialization operators, such as
deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrixdeserialize_matrix or deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModelDeserializeShapeModeldeserialize_shape_model。
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
参数
HandleHandleHandleHandlehandlehandle (输入控制) handle → HHandle, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle that should be serialized.
SerializedItemSerializedItemSerializedItemSerializedItemserializedItemserialized_item (输出控制) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle containing the serialized item.
示例(HDevelop)
create_matrix (3, 3, 0, MatrixID)
serialize_handle (MatrixID, SerializedMatrix)
deserialize_handle (SerializedMatrix, MatrixID2)
结果
如果参数有效,算子 serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle 返回值 2 ( H_MSG_TRUE )。否则,将抛出异常。
可能的前趋
tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializabletuple_is_serializable,
tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem
可能的后继
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle,
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item,
send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item
模块
基础