fread_serialized_item
— Einlesen eines serialisierten Elements aus einer Datei.
fread_serialized_item( : : FileHandle : SerializedItemHandle)
fread_serialized_item
liest ein serialisiertes Element,
welches mit fwrite_serialized_item
geschrieben wurde, aus der
aktuellen Eingabedatei mit dem Datei-Handle FileHandle
ein
(siehe fwrite_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 SerializedItemHandle
zurück.
Mit dem Operator open_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_item
mehrmals aufgerufen werden.
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.
FileHandle
(input_control) file →
(handle)
Datei-Handle.
SerializedItemHandle
(output_control) serialized_item →
(handle)
Handle des serialisierten Elements.
Sind die Parameterwerte korrekt, dann liefert
fread_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.
open_file
,
fwrite_serialized_item
close_file
,
get_serialized_item_ptr
,
deserialize_shape_model
,
deserialize_ncc_model
Foundation