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