ClassesClassesClassesClasses | | | | Operators

read_tupleread_tupleReadTupleread_tupleReadTupleReadTuple (Operator)

Name

read_tupleread_tupleReadTupleread_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)

Herror read_tuple(const HTuple& FileName, double* Tuple)

Herror 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)

void HOperatorSetX.ReadTuple(
[in] VARIANT FileName, [out] VARIANT* Tuple)

VARIANT HMiscX.ReadTuple([in] BSTR FileName)

VARIANT HTupleX.ReadTuple([in] VARIANT 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_tupleReadTupleread_tupleReadTupleReadTuple reads the contents of FileNameFileNameFileNameFileNameFileNamefileName and converts it into TupleTupleTupleTupleTupletuple. The default HALCON file extension for the tuple is 'tup'. The file has to be generated by write_tuplewrite_tupleWriteTuplewrite_tupleWriteTupleWriteTuple.

Parallelization

Parameters

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name of the file to be read.

File extension: .tup

TupleTupleTupleTupleTupletuple (output_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*) (double / Hlong / BSTR) (double / Hlong / char*)

Tuple with any kind of data.

Result

If the parameters are correct the operator read_tupleread_tupleReadTupleread_tupleReadTupleReadTuple returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Alternatives

fwrite_stringfwrite_stringFwriteStringfwrite_stringFwriteStringFwriteString

See also

write_tuplewrite_tupleWriteTuplewrite_tupleWriteTupleWriteTuple, gnuplot_plot_ctrlgnuplot_plot_ctrlGnuplotPlotCtrlgnuplot_plot_ctrlGnuplotPlotCtrlGnuplotPlotCtrl, write_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage, write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion, open_fileopen_fileOpenFileopen_fileOpenFileOpenFile

Module

Foundation


ClassesClassesClassesClasses | | | | Operators