fread_serialized_itemT_fread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item (Operator)
Name
fread_serialized_itemT_fread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item — Einlesen eines serialisierten Elements aus einer Datei.
Signatur
def fread_serialized_item(file_handle: HHandle) -> HHandle
Beschreibung
fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item liest ein serialisiertes Element,
welches mit fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item geschrieben wurde, aus der
aktuellen Eingabedatei mit dem Datei-Handle FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle ein
(siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung in die
Grundlagen der Serialisierung). Hierzu wird ein serialisiertes
Element erzeugt und die aus der Datei gelesenen Werte darin
gespeichert. Der Operator gibt das Handle des serialisierten
Elements in dem Parameter SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle zurück.
Mit dem Operator open_fileopen_fileOpenFileOpenFileOpenFileopen_file kann die Datei geöffnet werden.
Zu beachten ist, dass die Datei im Binärformat geöffnet werden muss.
Um mehrere serialisierte Elemente aus einer einzigen Eingabedatei zu
lesen, muss fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item mehrmals aufgerufen werden.
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.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Parameter
FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle (input_control) file → HFile, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Datei-Handle.
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des serialisierten Elements.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Der Fehlercode 9581 bedeutet hierbei, dass das Dateiende erreicht
wird, bevor ein serialisiertes Element gelesen werden kann.
Vorgänger
open_fileopen_fileOpenFileOpenFileOpenFileopen_file,
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item
Nachfolger
close_fileclose_fileCloseFileCloseFileCloseFileclose_file,
get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr,
deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModelDeserializeShapeModeldeserialize_shape_model,
deserialize_ncc_modeldeserialize_ncc_modelDeserializeNccModelDeserializeNccModelDeserializeNccModeldeserialize_ncc_model
Modul
Foundation