deserialize_measureT_deserialize_measureDeserializeMeasureDeserializeMeasuredeserialize_measure (Operator)

Name

deserialize_measureT_deserialize_measureDeserializeMeasureDeserializeMeasuredeserialize_measure — Deserialize a serialized measure object.

Signature

deserialize_measure( : : SerializedItemHandle : MeasureHandle)

Description

deserialize_measuredeserialize_measureDeserializeMeasureDeserializeMeasureDeserializeMeasuredeserialize_measure deserializes a measure object, that was serialized by serialize_measureserialize_measureSerializeMeasureSerializeMeasureSerializeMeasureserialize_measure (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized measure object is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created measure object with the handle MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle.

For an explanation of the concept of 1D measuring see the introduction of chapter 1D Measuring.

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

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)

Handle of the serialized item.

MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle (output_control) measure → (handle)

Measure object handle.

Result

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