fread_serialized_itemT_fread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item (Operator)

Name

fread_serialized_itemT_fread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item — Read a serialized item from a file.

Signature

fread_serialized_item( : : FileHandle : SerializedItemHandle)

Herror T_fread_serialized_item(const Htuple FileHandle, Htuple* SerializedItemHandle)

void FreadSerializedItem(const HTuple& FileHandle, HTuple* SerializedItemHandle)

void HSerializedItem::FreadSerializedItem(const HFile& FileHandle)

static void HOperatorSet.FreadSerializedItem(HTuple fileHandle, out HTuple serializedItemHandle)

void HSerializedItem.FreadSerializedItem(HFile fileHandle)

def fread_serialized_item(file_handle: HHandle) -> HHandle

Description

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item reads a serialized item, that was written by fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item from the current input file with the file handle FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item 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 SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The file can be opened by the operator open_fileopen_fileOpenFileOpenFileOpenFileopen_file. 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_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item must be called several times.

Execution Information

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.

Parameters

FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle (input_control)  file HFile, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

File handle.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control)  serialized_item HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

Result

If the parameters are valid, the operator fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item 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.

Possible Predecessors

open_fileopen_fileOpenFileOpenFileOpenFileopen_file, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item

Possible Successors

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

Module

Foundation