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_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle serialisiert den Inhalt von HandleHandleHandleHandlehandlehandle und gibt ihn als serialisiertes Objekt in SerializedItemSerializedItemSerializedItemSerializedItemserializedItemserialized_item zurück (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung in die Grundlagen der Serialisierung). Das serialisierte Objekt kann später mit deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_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_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializabletuple_is_serializable oder tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElemtuple_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_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrixdeserialize_matrix oder deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModelDeserializeShapeModeldeserialize_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

HandleHandleHandleHandlehandlehandle (input_control) handle → (handle)

Zu serialisierendes Handle.

SerializedItemSerializedItemSerializedItemSerializedItemserializedItemserialized_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_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializabletuple_is_serializable, tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem

Nachfolger

deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item

Modul

Foundation

Operatoren