write_memory_blockT_write_memory_blockWriteMemoryBlockWriteMemoryBlockwrite_memory_block (Operator)

Name

write_memory_blockT_write_memory_blockWriteMemoryBlockWriteMemoryBlockwrite_memory_block — Abspeichern eines Speicherblocks in eine Datei.

Signatur

write_memory_block( : : MemoryBlockHandle, FileName : )

Beschreibung

Der Operator write_memory_blockwrite_memory_blockWriteMemoryBlockWriteMemoryBlockwrite_memory_block schreibt den Byte-Inhalt des Speicherblocks MemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle in die Datei FileNameFileNameFileNamefileNamefile_name. Der Speicherblock kann mittels read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block wieder gelesen werden.

Die HALCON Standard-Dateiendung eines Speicherblocks ist '.bin'. Es kann aber eine beliebige Dateiendung ausgewählt werden, auch gar keine.

Achtung

Das Auswählen einer Dateiendung, die nicht zum Byte-Inhalt des Speicherblocks MemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle passt, ändert nur den Namen der Datei, nicht die geschriebenen Bytes.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

MemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle (input_control) memory_block → (handle)

Handle des Speicherblocks.

FileNameFileNameFileNamefileNamefile_name (input_control) filename.write → (string)

Name der Datei.

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

Dateiendung: .bin

Ergebnis

write_memory_blockwrite_memory_blockWriteMemoryBlockWriteMemoryBlockwrite_memory_block liefert den Wert 2 ( H_MSG_TRUE) , falls das übergebene Handle gültig ist und der Speicherblock erfolgreich in die Datei mit dem angegebenen Namen geschrieben werden konnte. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_memory_block_externcreate_memory_block_externCreateMemoryBlockExternCreateMemoryBlockExterncreate_memory_block_extern, create_memory_block_extern_copycreate_memory_block_extern_copyCreateMemoryBlockExternCopyCreateMemoryBlockExternCopycreate_memory_block_extern_copy, image_to_memory_blockimage_to_memory_blockImageToMemoryBlockImageToMemoryBlockimage_to_memory_block

Siehe auch

read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block

Modul

Foundation

Operatoren