read_tupleread_tupleReadTupleReadTupleread_tuple (算子)
名称
read_tupleread_tupleReadTupleReadTupleread_tuple — 从文件中读取元组。
签名
def read_tuple(file_name: str) -> Sequence[Union[float, int, str]]
def read_tuple_s(file_name: str) -> Union[float, int, str]
描述
算子 read_tupleread_tupleReadTupleReadTupleReadTupleread_tuple reads the contents of FileNameFileNameFileNameFileNamefileNamefile_name and
converts it into TupleTupleTupleTupletupletuple. The default HALCON file extension for the
tuple is 'tup'. The file has to be generated by write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple。
执行信息
- 多线程类型:独立(即使使用独占算子也能并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
参数
FileNameFileNameFileNameFileNamefileNamefile_name (输入控制) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the file to be read.
File extension:
.tup
TupleTupleTupleTupletupletuple (输出控制) tuple(-array) → HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Tuple with any kind of data.
结果
如果参数正确,算子 read_tupleread_tupleReadTupleReadTupleReadTupleread_tuple 返回值 2 ( H_MSG_TRUE )。否则将抛出异常。
替代
fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string
另见
write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple,
write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image,
write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region,
open_fileopen_fileOpenFileOpenFileOpenFileopen_file
模块
基础