HALCON 18.05 / HALCON Operator Reference / File / Tuple
ClassesClasses | | Operators

read_tupleread_tupleReadTupleReadTuple (Operator)

Name

read_tupleread_tupleReadTupleReadTuple — Read a tuple from a file.

Signature

read_tuple( : : FileName : Tuple)

Herror read_tuple(const char* FileName, double* Tuple)

Herror T_read_tuple(const Htuple FileName, Htuple* Tuple)

void ReadTuple(const HTuple& FileName, HTuple* Tuple)

static HTuple HMisc::ReadTuple(const HString& FileName)

static HTuple HMisc::ReadTuple(const char* FileName)

static HTuple HTuple::ReadTuple(const HTuple& FileName)

static void HOperatorSet.ReadTuple(HTuple fileName, out HTuple tuple)

static HTuple HMisc.ReadTuple(string fileName)

static HTuple HTuple.ReadTuple(HTuple fileName)

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

Parameters

FileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the file to be read.

File extension: .tup

TupleTupleTupleTupletuple (output_control)  number(-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

ClassesClasses | | Operators
HALCON Operator Reference 18.05 Copyright © 1996-2018 MVTec Software GmbH