deserialize_measureT_deserialize_measureDeserializeMeasureDeserializeMeasure (Operator)

Name

deserialize_measureT_deserialize_measureDeserializeMeasureDeserializeMeasure — Deserialize a serialized measure object.

Signature

deserialize_measure( : : SerializedItemHandle : MeasureHandle)

Herror T_deserialize_measure(const Htuple SerializedItemHandle, Htuple* MeasureHandle)

void DeserializeMeasure(const HTuple& SerializedItemHandle, HTuple* MeasureHandle)

void HMeasure::DeserializeMeasure(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeMeasure(HTuple serializedItemHandle, out HTuple measureHandle)

void HMeasure.DeserializeMeasure(HSerializedItem serializedItemHandle)

Description

deserialize_measuredeserialize_measureDeserializeMeasureDeserializeMeasureDeserializeMeasure deserializes a measure object, that was serialized by serialize_measureserialize_measureSerializeMeasureSerializeMeasureSerializeMeasure (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized measure object is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. The deserialized values are stored in an automatically created measure object with the handle MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle.

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

Execution Information

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control)  serialized_item HSerializedItem, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle (output_control)  measure HMeasure, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Measure object handle.

Result

If the parameters are valid, the operator deserialize_measuredeserialize_measureDeserializeMeasureDeserializeMeasureDeserializeMeasure 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_measureserialize_measureSerializeMeasureSerializeMeasureSerializeMeasure

Possible Successors

measure_posmeasure_posMeasurePosMeasurePosMeasurePos, measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairs

See also

read_measureread_measureReadMeasureReadMeasureReadMeasure, write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasure

Module

1D Metrology