deserialize_objectT_deserialize_objectDeserializeObjectDeserializeObjectdeserialize_object (Operator)

Name

deserialize_objectT_deserialize_objectDeserializeObjectDeserializeObjectdeserialize_object — Deserialize a serialized iconic object.

Signature

deserialize_object( : Object : SerializedItemHandle : )

Description

deserialize_objectdeserialize_objectDeserializeObjectDeserializeObjectDeserializeObjectdeserialize_object deserializes an iconic object, that was serialized by serialize_objectserialize_objectSerializeObjectSerializeObjectSerializeObjectserialize_object (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized iconic object is defined by the parameter SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized iconic object is stored in the iconic object defined by the parameter ObjectObjectObjectObjectobjectValobject.

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

ObjectObjectObjectObjectobjectValobject (output_object) object(-array) → object

Iconic object.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)

Handle of the serialized item.

Result

If the parameters are valid, the operator deserialize_objectdeserialize_objectDeserializeObjectDeserializeObjectDeserializeObjectdeserialize_object returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_objectserialize_objectSerializeObjectSerializeObjectSerializeObjectserialize_object

Module

Foundation

Operators