read_memory_blockT_read_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block (算子)
名称
read_memory_blockT_read_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block — 从文件中读取内存块。
签名
def read_memory_block(file_name: str) -> HHandle
描述
算子 read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block reads the file FileNameFileNameFileNameFileNamefileNamefile_name and
creates a new memory block in MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle that is an identical
copy of the bytes in the file.
The default HALCON file extension for memory block files is '.bin'.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。
参数
FileNameFileNameFileNameFileNamefileNamefile_name (输入控制) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the file.
默认值：
'memory_block.bin'
"memory_block.bin"
"memory_block.bin"
"memory_block.bin"
"memory_block.bin"
"memory_block.bin"
File extension:
.bin
MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle (输出控制) memory_block → HMemoryBlock, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Memory block handle.
结果
算子 read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block 返回值 2 (
H_MSG_TRUE)
if the named
file was found and correctly read.否则，将抛出异常。
模块
基础