deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle (Operator)

Name

deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle — 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)

def deserialize_handle(serialized_item: HHandle) -> HHandle

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

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 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