fread_serialized_itemT_fread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item (算子名称)
名称
fread_serialized_itemT_fread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item — Read a serialized item from a file.
参数签名
def fread_serialized_item(file_handle: HHandle) -> HHandle
描述
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.
运行信息
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- 未经并行化处理。
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.
参数表
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)
序列化项的句柄。
结果
如果参数均有效,算子
fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item 返回值 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_fileOpenFileOpenFileOpenFileopen_file,
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item
可能的后置算子
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
模块
Foundation