deserialize_objectT_deserialize_objectDeserializeObjectDeserializeObject (Operator)

Name

deserialize_objectT_deserialize_objectDeserializeObjectDeserializeObject — Deserialize a serialized iconic object.

Signature

deserialize_object( : Object : SerializedItemHandle : )

Description

deserialize_objectdeserialize_objectDeserializeObjectDeserializeObjectDeserializeObject deserializes an iconic object, that was serialized by serialize_objectserialize_objectSerializeObjectSerializeObjectSerializeObject (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized iconic object is defined by the parameter SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. The deserialized iconic object is stored in the iconic object defined by the parameter ObjectObjectObjectObjectobjectVal.

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

ObjectObjectObjectObjectobjectVal (output_object) object(-array) → object

Iconic object.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control) serialized_item → (handle)

Handle of the serialized item.

Result

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

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem, serialize_objectserialize_objectSerializeObjectSerializeObjectSerializeObject

Module

Foundation

Operators