serialize_tupleT_serialize_tupleSerializeTupleSerializeTuple (Operator)

Name

serialize_tupleT_serialize_tupleSerializeTupleSerializeTuple — Serialisieren eines Tuples.

Signatur

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()

Beschreibung

serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTuple serialisiert die Daten eines Tuples (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Dabei werden dieselben Daten in ein serialisiertes Element überführt, die von write_tuplewrite_tupleWriteTupleWriteTupleWriteTuple in eine Datei geschrieben werden. Das Tupel wird in dem Handle TupleTupleTupleTupletuple übergeben. Die serialisierten Daten des Tuples werden in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle zurückgegeben und können mit deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTuple wieder deserialisiert werden.

Nicht alle Handle-Typen können serialisiert werden. Wenn TupleTupleTupleTupletuple ein Handle enthält, das nicht serialisiert werden kann oder das schon freigegeben wurde, bricht serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTuple mit einer Fehlermeldung ab. Die Operatoren tuple_is_serializable und tuple_is_serializable_elem können verwendet werden, um zu prüfen, ob ein Tupel oder dessen Einträge serialisiert werden können.

Ausführungsinformationen

Parameter

TupleTupleTupleTupletuple (input_control)  tuple(-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 des serialisierten Elements.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTuple den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem, deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTuple

Modul

Foundation