Skip to content

deserialize_tupleDeserializeTupleDeserializeTupledeserialize_tupleT_deserialize_tuple🔗

Short description🔗

deserialize_tupleDeserializeTupleDeserializeTupledeserialize_tupleT_deserialize_tuple — Deserialize a serialized tuple.

Signature🔗

deserialize_tuple( serialized_item SerializedItemHandle, out tuple Tuple )void DeserializeTuple( const HTuple& SerializedItemHandle, HTuple* Tuple )static void HOperatorSet.DeserializeTuple( HTuple serializedItemHandle, out HTuple tuple )def deserialize_tuple( serialized_item_handle: HHandle ) -> Sequence[HTupleElementType]

def deserialize_tuple_s( serialized_item_handle: HHandle ) -> HTupleElementTypeHerror T_deserialize_tuple( const Htuple SerializedItemHandle, Htuple* Tuple )

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

static HTuple HTuple.DeserializeTuple( HSerializedItem serializedItemHandle )

Description🔗

deserialize_tupleDeserializeTuple deserializes the data of a tuple, that was serialized by serialize_tupleSerializeTuple (see fwrite_serialized_itemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized data of the tuple is defined by the handle SerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created tuple with the handle Tupletupletuple.

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.

Tupletupletuple (output_control) tuple(-array) → (real / integer / string / handle)HTuple (double / Hlong / HString / HHandle)HTuple (double / int / long / string / HHandle)Sequence[HTupleElementType]Htuple (double / Hlong / char* / handle)

Tuple.

Result🔗

If the parameters are valid, the operator deserialize_tupleDeserializeTuple 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_tupleSerializeTuple

Module🔗

Foundation