serialize_handleT_serialize_handleSerializeHandleSerializeHandleserialize_handle (Operator)

Name

serialize_handleT_serialize_handleSerializeHandleSerializeHandleserialize_handle — Serialisieren des Inhalts eines Handles.

Signatur

serialize_handle( : : Handle : SerializedItem)

Beschreibung

serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle serialisiert den Inhalt von HandleHandleHandlehandlehandle und gibt ihn als serialisiertes Objekt in SerializedItemSerializedItemSerializedItemserializedItemserialized_item zurück (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung in die Grundlagen der Serialisierung). Das serialisierte Objekt kann später mit deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle wieder deserialisiert werden.

Nicht alle Handletypen können serialisiert werden. Ob ein Handle serialisiert werden kann, kann zur Laufzeit mit tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializabletuple_is_serializable oder tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem 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_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix oder deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModeldeserialize_shape_model.

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.

SerializedItemSerializedItemSerializedItemserializedItemserialized_item (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_handleSerializeHandleSerializeHandleserialize_handle den Wert 2 ( H_MSG_TRUE) . Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializabletuple_is_serializable, tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem

Nachfolger

deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item

Modul

Foundation

Operatoren