serialize_tupleT_serialize_tupleSerializeTupleSerializeTupleserialize_tuple (Operator)

Name

serialize_tupleT_serialize_tupleSerializeTupleSerializeTupleserialize_tuple — Serialize a tuple.

Signature

serialize_tuple( : : Tuple : SerializedItemHandle)

Description

serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTupleserialize_tuple serializes the data of a tuple (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The same data that is written in a file by write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple is converted to a serialized item. The tuple is defined by the handle TupleTupleTupleTupletupletuple. The serialized data of a tuple is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTupledeserialize_tuple.

Note that not all handle types can be serialized. If TupleTupleTupleTupletupletuple contains a handle that can not be serialized or that has been freed already, an exception is raised. The operators tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializabletuple_is_serializable and tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem can be used to find out if a tuple or its elements can be serialized.

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

TupleTupleTupleTupletupletuple (input_control) tuple(-array) → (real / integer / string / handle)

Tuple.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control) serialized_item → (handle)

Handle of the serialized item.

Result

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

Possible Successors

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item, deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTupledeserialize_tuple

Module

Foundation

Operators