HALCON Reference Manual 10.0.2
Table of Contents / File / Tuple ClassesClassesClasses | | | Operators

read_tupleread_tupleread_tupleReadTupleReadTuple (Operator)

Name

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

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

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

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

VARIANT HMiscX.ReadTuple([in] BSTR FileName)

VARIANT HTupleX.ReadTuple([in] BSTR FileName)

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

static HTuple HMisc.ReadTuple(string fileName)

static HTuple HTuple.ReadTuple(string fileName)

Description

The operator read_tupleread_tupleread_tupleReadTupleReadTuple 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_tuplewrite_tupleWriteTupleWriteTuple.

Parallelization

Parameters

FileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Name of the file to be read.

File extension: .tup

TupleTupleTupleTupletuple (output_control)  number(-array) → HTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (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_tupleread_tupleReadTupleReadTuple returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Alternatives

fwrite_stringfwrite_stringfwrite_stringFwriteStringFwriteString

See also

write_tuplewrite_tuplewrite_tupleWriteTupleWriteTuple, gnuplot_plot_ctrlgnuplot_plot_ctrlgnuplot_plot_ctrlGnuplotPlotCtrlGnuplotPlotCtrl, write_imagewrite_imagewrite_imageWriteImageWriteImage, write_regionwrite_regionwrite_regionWriteRegionWriteRegion, open_fileopen_fileopen_fileOpenFileOpenFile

Module

Foundation

Table of Contents / File / Tuple ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH