Skip to content

deserialize_handleDeserializeHandleDeserializeHandledeserialize_handleT_deserialize_handle🔗

Short description🔗

deserialize_handleDeserializeHandleDeserializeHandledeserialize_handleT_deserialize_handle — Deserialize a serialized item.

Signature🔗

deserialize_handle( serialized_item SerializedItem, out handle Handle )void DeserializeHandle( const HTuple& SerializedItem, HTuple* Handle )static void HOperatorSet.DeserializeHandle( HTuple serializedItem, out HTuple handle )def deserialize_handle( serialized_item: HHandle ) -> HHandle

Herror T_deserialize_handle( const Htuple SerializedItem, Htuple* Handle )

void HHandle::DeserializeHandle( const HSerializedItem& SerializedItem )

void HHandle.DeserializeHandle( HSerializedItem serializedItem )

Description🔗

deserialize_handleDeserializeHandle deserializes the content of SerializedItemserializedItemserialized_item and returns the deserialized item in Handlehandlehandle (see fwrite_serialized_itemFwriteSerializedItem for an introduction of the basic principle of serialization).

The serialized item must have been created by serialize_handleSerializeHandle, or by the type specific serialization operators, such as serialize_matrixSerializeMatrix or serialize_shape_modelSerializeShapeModel.

Execution information🔗

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🔗

SerializedItemserializedItemserialized_item (input_control) serialized_item → (handle)HTuple (HHandle)HSerializedItem, HTuple (IntPtr)HHandleHtuple (handle)

Handle containing the serialized item to be deserialized.

Handlehandlehandle (output_control) handle → (handle)HTuple (HHandle)HHandle, HTuple (IntPtr)HHandleHtuple (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_handleDeserializeHandle returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

serialize_handleSerializeHandle, fread_serialized_itemFreadSerializedItem, receive_serialized_itemReceiveSerializedItem

Module🔗

Foundation