write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple (算子名称)
名称
write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple — Write a tuple to a file.
参数签名
def write_tuple(tuple: MaybeSequence[Union[float, int, str]], file_name: str) -> None
描述
该算子 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.
运行信息
- Multithreading type: independent (runs in parallel even with exclusive operators).
- 多线程作用域:全局(可以从任何线程调用)。
- 未经并行化处理。
参数表
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
结果
If the parameters are correct 该算子 write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple
返回值 2 (
H_MSG_TRUE)
. Otherwise an exception is raised.
可替代算子
fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string
参考其它
read_tupleread_tupleReadTupleReadTupleReadTupleread_tuple,
write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image,
write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region,
open_fileopen_fileOpenFileOpenFileOpenFileopen_file
模块
Foundation