deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle (Operator)

Name

deserialize_handleT_deserialize_handleDeserializeHandleDeserializeHandledeserialize_handle — Deserialisieren eines Handles.

Signatur

deserialize_handle( : : SerializedItem : Handle)

Beschreibung

deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle deserialisiert den Inhalt von SerializedItemSerializedItemSerializedItemserializedItemserialized_item und gibt das deserialisierte Objekt in HandleHandleHandlehandlehandle zurück (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung in die Grundlagen der Serialisierung).

Das serialisierte Objekt muss mit serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle oder einem typspezifischen Serialisierungsoperator wie serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix oder serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelserialize_shape_model erstellt worden sein.

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

SerializedItemSerializedItemSerializedItemserializedItemserialized_item (input_control) serialized_item → (handle)

Handle des serialisierten Elements.

HandleHandleHandlehandlehandle (output_control) handle → (handle)

Handle des deserialisierten Elements.

Beispiel (HDevelop)

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

Ergebnis

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

Vorgänger

serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle, fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item

Modul

Foundation

Operatoren