ClassesClasses | | Operators

deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandle (Operator)

Name

deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandle — Deserialize a serialized item.

Signature

deserialize_handle( : : SerializedItem : Handle)

Herror T_deserialize_handle(const Htuple SerializedItem, Htuple* Handle)

void DeserializeHandle(const HTuple& SerializedItem, HTuple* Handle)

void HHandle::DeserializeHandle(const HSerializedItem& SerializedItem)

static void HOperatorSet.DeserializeHandle(HTuple serializedItem, out HTuple handle)

void HHandle.DeserializeHandle(HSerializedItem serializedItem)

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

Parameters

SerializedItemSerializedItemSerializedItemSerializedItemserializedItem (input_control)  serialized_item HSerializedItem, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle containing the serialized item to be deserialized.

HandleHandleHandleHandlehandle (output_control)  handle HHandle, HTupleHTupleHtuple (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_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


ClassesClasses | | Operators