deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupledeserialize_tupleT_deserialize_tuple
Short description
deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupledeserialize_tupleT_deserialize_tuple — Deserialize a serialized tuple.
Signature
deserialize_tuple( serialized_item SerializedItemHandle, out tuple Tuple )deserialize_tuple( : : SerializedItemHandle : 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
-
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)(handle)HTuple (HHandle)HSerializedItem, HTuple (IntPtr)HHandleHtuple (handle)
Handle of the serialized item.
Tupletupletuple (output_control) tuple(-array) → (real / integer / string / handle)(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