write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple (Operator)
Name
write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple — Write a tuple to a file.
Signature
def write_tuple(tuple: MaybeSequence[Union[float, int, str]], file_name: str) -> None
Description
The operator write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple writes the contents of TupleTupleTupleTupletupletuple 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'.
Exception: Handles
Note that write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple does not support handles, since binary data
is not supported by the underlying ASCII format.
Any handle contained in TupleTupleTupleTupletupletuple is replaced by the integer 0.
To write a tuple that contains handles, use serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTupleserialize_tuple and
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item.
Execution Information
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
TupleTupleTupleTupletupletuple (input_control) tuple(-array) → HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Tuple with any kind of data.
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the file to be written.
File extension:
.tup
Result
If the parameters are correct the operator write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple
returns the value 2 (
H_MSG_TRUE)
. Otherwise an exception is raised.
Alternatives
fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string
See also
read_tupleread_tupleReadTupleReadTupleReadTupleread_tuple,
write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image,
write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region,
open_fileopen_fileOpenFileOpenFileOpenFileopen_file
Module
Foundation