fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem (Operator)

Name

fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem — Einlesen eines serialisierten Elements aus einer Datei.

Signatur

fread_serialized_item( : : FileHandle : SerializedItemHandle)

Beschreibung

fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem liest ein serialisiertes Element, welches mit fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem geschrieben wurde, aus der aktuellen Eingabedatei mit dem Datei-Handle FileHandleFileHandleFileHandleFileHandleFileHandlefileHandle ein (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem 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 SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle zurück. Mit dem Operator open_fileopen_fileOpenFileopen_fileOpenFileOpenFile 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_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem mehrmals aufgerufen werden.

Parallelisierung

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

FileHandleFileHandleFileHandleFileHandleFileHandlefileHandle (input_control) file → (integer)

Datei-Handle.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (output_control) serialized_item → (integer)

Handle des serialisierten Elements.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem 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_fileOpenFileopen_fileOpenFileOpenFile, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem

Nachfolger

close_fileclose_fileCloseFileclose_fileCloseFileCloseFile, get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtr, deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModel, deserialize_ncc_modeldeserialize_ncc_modelDeserializeNccModeldeserialize_ncc_modelDeserializeNccModelDeserializeNccModel

Modul

Foundation

Operatoren