Name
fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem — Read a serialized item from a file.
fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem reads a serialized item, that was
written by fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem from the current input
file with the file handle FileHandleFileHandleFileHandleFileHandleFileHandlefileHandle (see
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem for an introduction of the basics
of serialization). For this, a serialized item is created and
the values read from file are stored in the serialized item. The
operator returns the handle of the serialized item in the parameter
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. The file can be opened by the
operator open_fileopen_fileOpenFileopen_fileOpenFileOpenFile. Note that the file must be open in
binary format. For reading more than on item from one file the
operator fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem must be called several
times.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
Handle of the serialized item.
If the parameters are valid, the operator
fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.
The error code 9581 indicates that the end of file is reached before
a serialized item could be read.
open_fileopen_fileOpenFileopen_fileOpenFileOpenFile,
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem
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
Foundation