read_tupleread_tupleReadTupleReadTuple (Operator)
Name
read_tupleread_tupleReadTupleReadTuple — Read a tuple from a file.
Signature
Description
The operator read_tupleread_tupleReadTupleReadTupleReadTuple reads the contents of FileNameFileNameFileNameFileNamefileName and
converts it into TupleTupleTupleTupletuple. The default HALCON file extension for the
tuple is 'tup'. The file has to be generated by write_tuplewrite_tupleWriteTupleWriteTupleWriteTuple.
Execution Information
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
FileNameFileNameFileNameFileNamefileName (input_control) filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name of the file to be read.
File extension: .tup
TupleTupleTupleTupletuple (output_control) tuple(-array) → HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Tuple with any kind of data.
Result
If the parameters are correct the operator read_tupleread_tupleReadTupleReadTupleReadTuple
returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.
Alternatives
fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString
See also
write_tuplewrite_tupleWriteTupleWriteTupleWriteTuple,
write_imagewrite_imageWriteImageWriteImageWriteImage,
write_regionwrite_regionWriteRegionWriteRegionWriteRegion,
open_fileopen_fileOpenFileOpenFileOpenFile
Module
Foundation