deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandle (Operator)

Name

deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandle — Deserialize a serialized item.

Signature

deserialize_handle( : : SerializedItem : Handle)

Description

deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle deserializes the content of SerializedItemSerializedItemSerializedItemSerializedItemserializedItem and returns the deserialized item in HandleHandleHandleHandlehandle (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basic principle of serialization).

The serialized item must have been created by serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandle, or by the type specific serialization operators, such as serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrix or serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModel.

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

SerializedItemSerializedItemSerializedItemSerializedItemserializedItem (input_control) serialized_item → (handle)

Handle containing the serialized item to be deserialized.

HandleHandleHandleHandlehandle (output_control) handle → (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_handleDeserializeHandleDeserializeHandleDeserializeHandle returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.

Possible Predecessors

serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandle, fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem

Module

Foundation

Operators