ClassesClasses | | Operators

serialize_tupleT_serialize_tupleSerializeTupleSerializeTuple (Operator)

Name

serialize_tupleT_serialize_tupleSerializeTupleSerializeTuple — Serialize a tuple.

Signature

serialize_tuple( : : Tuple : SerializedItemHandle)

Herror T_serialize_tuple(const Htuple Tuple, Htuple* SerializedItemHandle)

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

HSerializedItem HTuple::SerializeTuple() const

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

HSerializedItem HTuple.SerializeTuple()

Description

serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTuple serializes the data of a tuple (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basic principle of serialization). The same data that is written in a file by write_tuplewrite_tupleWriteTupleWriteTupleWriteTuple is converted to a serialized item. The tuple is defined by the handle TupleTupleTupleTupletuple. The serialized data of a tuple is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle and can be deserialized by deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTuple.

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

Execution Information

Parameters

TupleTupleTupleTupletuple (input_control)  number(-array) HTupleHTupleHtuple (real / integer / string / handle) (double / int / long / string / HHandle) (double / Hlong / HString / HHandle) (double / Hlong / char* / handle)

Tuple.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (output_control)  serialized_item HSerializedItem, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

Result

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

Possible Successors

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem, deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTuple

Module

Foundation


ClassesClasses | | Operators