Skip to content

deserialize_measureDeserializeMeasureDeserializeMeasuredeserialize_measureT_deserialize_measure🔗

Short description🔗

deserialize_measureDeserializeMeasureDeserializeMeasuredeserialize_measureT_deserialize_measure — Deserialize a serialized measure object.

Signature🔗

deserialize_measure( serialized_item SerializedItemHandle, out measure MeasureHandle )void DeserializeMeasure( const HTuple& SerializedItemHandle, HTuple* MeasureHandle )static void HOperatorSet.DeserializeMeasure( HTuple serializedItemHandle, out HTuple measureHandle )def deserialize_measure( serialized_item_handle: HHandle ) -> HHandle

Herror T_deserialize_measure( const Htuple SerializedItemHandle, Htuple* MeasureHandle )

void HMeasure::DeserializeMeasure( const HSerializedItem& SerializedItemHandle )

void HMeasure.DeserializeMeasure( HSerializedItem serializedItemHandle )

Description🔗

deserialize_measureDeserializeMeasure deserializes a measure object, that was serialized by serialize_measureSerializeMeasure (see fwrite_serialized_itemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized measure object is defined by the handle SerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created measure object with the handle MeasureHandlemeasureHandlemeasure_handle.

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

Execution information🔗

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🔗

SerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)HTuple (HHandle)HSerializedItem, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the serialized item.

MeasureHandlemeasureHandlemeasure_handle (output_control) measure → (handle)HTuple (HHandle)HMeasure, HTuple (IntPtr)HHandleHtuple (handle)

Measure object handle.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

fread_serialized_itemFreadSerializedItem, receive_serialized_itemReceiveSerializedItem, serialize_measureSerializeMeasure

Possible successors

measure_posMeasurePos, measure_pairsMeasurePairs

See also

read_measureReadMeasure, write_measureWriteMeasure

Module🔗

1D Metrology