write_memory_blockT_write_memory_blockWriteMemoryBlockWriteMemoryBlockwrite_memory_block (算子)
名称
write_memory_blockT_write_memory_blockWriteMemoryBlockWriteMemoryBlockwrite_memory_block — 将内存块写入文件。
签名
描述
算子 write_memory_blockwrite_memory_blockWriteMemoryBlockWriteMemoryBlockWriteMemoryBlockwrite_memory_block writes the byte content of the memory
block MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle to the file FileNameFileNameFileNameFileNamefileNamefile_name. The memory
block can be read again with read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block。
The default HALCON file extension for memory block files is '.bin', but any
file extension can be chosen, including none.
注意
Choosing a file extension that does not fit the byte content of the memory
block MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle only changes the name of the file, not the
bytes written to disk.
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
参数
MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle (输入控制) memory_block → HMemoryBlock, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Memory block handle.
FileNameFileNameFileNameFileNamefileNamefile_name (输入控制) filename.write → 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
结果
算子 write_memory_blockwrite_memory_blockWriteMemoryBlockWriteMemoryBlockWriteMemoryBlockwrite_memory_block 返回值 2 (
H_MSG_TRUE)
if the
passed handle is valid and if the memory block was successfully written into
the named file.否则,将抛出异常。
模块
基础