deserialize_regionT_deserialize_regionDeserializeRegionDeserializeRegiondeserialize_region (Operator)

Name

deserialize_regionT_deserialize_regionDeserializeRegionDeserializeRegiondeserialize_region — Deserialize a serialized region.

Signature

deserialize_region( : Region : SerializedItemHandle : )

Description

deserialize_regiondeserialize_regionDeserializeRegionDeserializeRegionDeserializeRegiondeserialize_region deserializes a region, that was serialized by serialize_regionserialize_regionSerializeRegionSerializeRegionSerializeRegionserialize_region (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized region is defined by the parameter SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized region is stored in the region defined by the parameter RegionRegionRegionRegionregionregion.

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

RegionRegionRegionRegionregionregion (output_object) region(-array) → object

Region.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)

Handle of the serialized item.

Result

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