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

write_tuplewrite_tupleWriteTupleWriteTuple (Operator)

Name

write_tuplewrite_tupleWriteTupleWriteTuple — Write a tuple to a file.

Signature

write_tuple( : : Tuple, FileName : )

Herror write_tuple(double Tuple, const char* FileName)

Herror T_write_tuple(const Htuple Tuple, const Htuple FileName)

void WriteTuple(const HTuple& Tuple, const HTuple& FileName)

static void HMisc::WriteTuple(const HTuple& Tuple, const HString& FileName)

static void HMisc::WriteTuple(double Tuple, const HString& FileName)

static void HMisc::WriteTuple(double Tuple, const char* FileName)

void HTuple::WriteTuple(const HTuple& FileName) const

static void HOperatorSet.WriteTuple(HTuple tuple, HTuple fileName)

static void HMisc.WriteTuple(HTuple tuple, string fileName)

static void HMisc.WriteTuple(double tuple, string fileName)

void HTuple.WriteTuple(HTuple fileName)

Description

The operator write_tuplewrite_tupleWriteTupleWriteTupleWriteTuple writes the contents of TupleTupleTupleTupletuple to a file. The data is written in an ASCII format. Therefore, the file can be exchanged between different architectures (see also Tuple / String Operations). The default HALCON file extension for the tuple is 'tup'.

Execution Information

Parameters

TupleTupleTupleTupletuple (input_control)  number(-array) → HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Tuple with any kind of data.

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

Name of the file to be written.

File extension: .tup

Result

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

Alternatives

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString

See also

read_tupleread_tupleReadTupleReadTupleReadTuple, write_imagewrite_imageWriteImageWriteImageWriteImage, write_regionwrite_regionWriteRegionWriteRegionWriteRegion, open_fileopen_fileOpenFileOpenFileOpenFile

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH