Operator Reference

HALCON Operator Reference / File / Tuple
ClassesClasses | | Operators

deserialize_tupleT_deserialize_tupleDeserializeTupleDeserializeTupledeserialize_tuple (Operator)

deserialize_tupleT_deserialize_tupleDeserializeTupleDeserializeTupledeserialize_tuple — Deserialize a serialized tuple.

Signature

deserialize_tuple( : : SerializedItemHandle : Tuple)

Herror T_deserialize_tuple(const Htuple SerializedItemHandle, Htuple* Tuple)

void DeserializeTuple(const HTuple& SerializedItemHandle, HTuple* Tuple)

static HTuple HTuple::DeserializeTuple(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeTuple(HTuple serializedItemHandle, out HTuple tuple)

static HTuple HTuple.DeserializeTuple(HSerializedItem serializedItemHandle)

def deserialize_tuple(serialized_item_handle: HHandle) -> Sequence[HTupleElementType]

def deserialize_tuple_s(serialized_item_handle: HHandle) -> HTupleElementType

Description

deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupledeserialize_tuple deserializes the data of a tuple, that was serialized by serialize_tupleserialize_tupleSerializeTupleSerializeTupleserialize_tuple (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized data of the tuple is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created tuple with the handle TupleTupleTupletupletuple.

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

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control)  serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

TupleTupleTupletupletuple (output_control)  tuple(-array) → HTupleSequence[HTupleElementType]HTupleHtuple (real / integer / string / handle) (double / int / long / string / HHandle) (double / Hlong / HString / HHandle) (double / Hlong / char* / handle)

Tuple.

Result

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

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_tupleserialize_tupleSerializeTupleSerializeTupleserialize_tuple

Module

Foundation

ClassesClasses | | Operators