write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple (算子)
名称
write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple — 将元组写入文件。
签名
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。
执行信息
- 多线程类型：独立（即使使用独占算子也能并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
TupleTupleTupleTupletupletuple (输入控制) 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 (输入控制) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the file to be written.
File extension:
.tup
结果
如果参数正确，算子 write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple 返回值 2 ( H_MSG_TRUE )。否则将抛出异常。
替代
fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string
另见
read_tupleread_tupleReadTupleReadTupleReadTupleread_tuple,
write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image,
write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region,
open_fileopen_fileOpenFileOpenFileOpenFileopen_file
模块
基础