serialize_tuple
— Serialisieren eines Tuples.
serialize_tuple( : : Tuple : SerializedItemHandle)
serialize_tuple
serialisiert die Daten eines
Tuples (siehe fwrite_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_tuple
in eine Datei geschrieben werden.
Das Tupel wird in dem Handle Tuple
übergeben.
Die serialisierten Daten des Tuples werden in dem Handle
SerializedItemHandle
zurückgegeben und können mit
deserialize_tuple
wieder deserialisiert werden.
Nicht alle Handle-Typen können serialisiert werden.
Wenn Tuple
ein Handle enthält, das nicht serialisiert werden
kann oder das schon freigegeben wurde, bricht serialize_tuple
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.
Tuple
(input_control) tuple(-array) →
(real / integer / string / handle)
Tuple.
SerializedItemHandle
(output_control) serialized_item →
(handle)
Handle des serialisierten Elements.
Sind die Parameterwerte korrekt, dann liefert
serialize_tuple
den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
fwrite_serialized_item
,
send_serialized_item
,
deserialize_tuple
Foundation