write_tuplewrite_tupleWriteTupleWriteTuple (Operator)


write_tuplewrite_tupleWriteTupleWriteTuple — Write a tuple to a file.


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(const HTuple& Tuple, const char* FileName)

static void HMisc::WriteTuple(const HTuple& Tuple, const wchar_t* FileName)   (Windows only)

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

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

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

void HTuple.WriteTuple(HTuple fileName)


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'.

Note that write_tuplewrite_tupleWriteTupleWriteTupleWriteTuple does not support handles, since binary data is not supported by the underlying ASCII format. An exception is raised when passing a tuple that contains handles. To write a tuple that contains handles, use serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTuple and fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem.

Execution Information


TupleTupleTupleTupletuple (input_control)  tuple(-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


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



See also

read_tupleread_tupleReadTupleReadTupleReadTuple, write_imagewrite_imageWriteImageWriteImageWriteImage, write_regionwrite_regionWriteRegionWriteRegionWriteRegion, open_fileopen_fileOpenFileOpenFileOpenFile