read_memory_blockT_read_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block (算子名称)

名称

read_memory_blockT_read_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block — Read a memory block from a file.

参数签名

read_memory_block( : : FileName : MemoryBlockHandle)

描述

该算子 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'.

运行信息

多线程类型:可重入(与非独占操作符并行运行)。
多线程作用域:全局(可以从任何线程调用)。
未经并行化处理。

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.

参数表

FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → (string)

Name of the file.

Default: 'memory_block.bin' "memory_block.bin" "memory_block.bin" "memory_block.bin" "memory_block.bin" "memory_block.bin"

File extension: .bin

MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle (output_control) memory_block → (handle)

Memory block handle.

结果

该算子 read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block 返回值 2 ( H_MSG_TRUE) if the named file was found and correctly read. Otherwise, an exception is raised.

模块

Foundation

算子列表