serialize_handleT_serialize_handleSerializeHandleSerializeHandle (Operator)

Name

serialize_handleT_serialize_handleSerializeHandleSerializeHandle — Serialisieren des Inhalts eines Handles.

Signatur

serialize_handle( : : Handle : SerializedItem)

Beschreibung

serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandle serialisiert den Inhalt von HandleHandleHandleHandlehandle und gibt ihn als serialisiertes Objekt in SerializedItemSerializedItemSerializedItemSerializedItemserializedItem zurück (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Das serialisierte Objekt kann später mit deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle wieder deserialisiert werden.

Nicht alle Handletypen können serialisiert werden. Ob ein Handle serialisiert werden kann, kann zur Laufzeit mit tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializable oder tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElem geprüft werden. Bereits freigegebene Handles können nicht serialisiert werden.

Die von diesem Operator erzeugten serialisierten Objekte sind kompatibel mit den typspezifischen Deserialisierungsoperatoren, wie beispielsweise deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrix oder deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModelDeserializeShapeModel.

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

HandleHandleHandleHandlehandle (input_control) handle → (handle)

Zu serialisierendes Handle.

SerializedItemSerializedItemSerializedItemSerializedItemserializedItem (output_control) serialized_item → (handle)

Handle des serialisierten Elements.

Beispiel (HDevelop)

create_matrix (3, 3, 0, MatrixID)
serialize_handle (MatrixID, SerializedMatrix)
deserialize_handle (SerializedMatrix, MatrixID2)

Ergebnis

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

Vorgänger

tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializable, tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElem

Nachfolger

deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem

Modul

Foundation

Operatoren