deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle (Operator)
Name
deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle — Deserialize a serialized item.
Signature
Description
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle deserializes the content of
SerializedItemSerializedItemSerializedItemSerializedItemserializedItemserialized_item and returns the deserialized item in
HandleHandleHandleHandlehandlehandle
(see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic
principle of serialization).
The serialized item must have been created by serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle,
or by the type specific serialization operators, such as
serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrixserialize_matrix or serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModelserialize_shape_model.
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
SerializedItemSerializedItemSerializedItemSerializedItemserializedItemserialized_item (input_control) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle containing the serialized item to be deserialized.
HandleHandleHandleHandlehandlehandle (output_control) handle → HHandle, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle containing the deserialized item.
Example (HDevelop)
create_matrix (3, 3, 0, MatrixID)
serialize_handle (MatrixID, SerializedMatrix)
deserialize_handle (SerializedMatrix, MatrixID2)
Result
If the parameters are valid, the operator deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle
returns the value 2 (
H_MSG_TRUE)
. Otherwise, an exception is raised.
Possible Predecessors
serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle,
fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item,
receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item
Module
Foundation