serialize_tupleT_serialize_tupleSerializeTupleSerializeTupleserialize_tuple (Operator)

Name

serialize_tupleT_serialize_tupleSerializeTupleSerializeTupleserialize_tuple — Serialisieren eines Tupels.

Signatur

serialize_tuple( : : Tuple : SerializedItemHandle)

Beschreibung

serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTupleserialize_tuple serialisiert die Daten eines Tupels (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung in die Grundlagen der Serialisierung). Dabei werden dieselben Daten in ein serialisiertes Element überführt, die von write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple in eine Datei geschrieben werden. Das Tupel wird in dem Handle TupleTupleTupleTupletupletuple übergeben. Die serialisierten Daten des Tupels werden in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle zurückgegeben und können mit deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTupledeserialize_tuple wieder deserialisiert werden.

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

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

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

Tupel.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control) serialized_item → (handle)

Handle des serialisierten Elements.

Ergebnis

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

Nachfolger

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item, deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTupledeserialize_tuple

Modul

Foundation

Operatoren