Halcon参考手册，第二十八章 Tuple, 元组
第二十八章 Tuple, 元组
28.1 Arithmetic，计算
操作符列表
tuple_abs
计算元组的绝对值。
tuple_acos
计算元组的反余弦。
tuple_add
添加两个元组。
tuple_asin
计算元组的反正弦值。
tuple_atan
计算一个元组的反正切。
tuple_atan2
计算所有四个象限的元组的反正切。
tuple_ceil
计算元组的上限函数。
tuple_cos
计算元组的余弦值。
tuple_cosh
计算元组的双曲余弦。
tuple_cumul
计算元组的累积和。
tuple_deg
将一个元组从弧度转换为角度。
tuple_div
除两个元组。
tuple_exp
计算一个元组的指数。
tuple_fabs
计算元组的绝对值(作为浮点数)。
tuple_floor
计算元组的底函数。
tuple_fmod
计算两个元组浮点除法的余数。
tuple_ldexp
计算两个元组的ldexp函数。
tuple_log
计算元组的自然对数。
tuple_log10
计算以10为底的元组的对数。
tuple_max2
计算两个元组的元素最大值。
tuple_min2
计算两个元组的元素最小值。
tuple_mod
计算两个元组的整数除法的余数。
tuple_mult
两个元组相乘。
tuple_neg
对元组取反。
tuple_pow
计算两个元组的幂函数。
tuple_rad
将元组从角度转换为弧度。
tuple_sgn
计算元组的符号。
tuple_sin
计算一个元组的正弦值。
tuple_sinh
计算元组的双曲正弦值。
tuple_sqrt
计算元组的平方根。
tuple_sub
减去两个元组。
tuple_tan
计算一个元组的正切。
tuple_tanh
计算元组的双曲正切。
28.2 Bit Operations，位运算
操作符列表
tuple_band
按位计算两个元组的和。
tuple_bnot
计算元组的位非。
tuple_bor
计算两个元组的按位或。
tuple_bxor
计算两个元组的位异或。
tuple_lsh
将元组按位向左移动。
tuple_rsh
将元组向右按位移动。
28.3 Comparison，比较
操作符列表
tuple_equal
测试两个元组是否相等。
tuple_equal_elem
测试两个元组在元素上是否相等。
tuple_greater
测试一个元组是否大于另一个元组。
tuple_greater_elem
测试一个元组在元素上是否大于另一个元组。
tuple_greater_equal
测试一个元组是否大于或等于另一个元组。
tuple_greater_equal_elem
测试一个元组在元素上是否大于或等于另一个元组。
tuple_less
测试一个元组是否小于另一个元组。
tuple_less_elem
测试一个元组在元素上是否小于另一个元组。
tuple_less_equal
测试一个元组是否小于或等于另一个元组。
tuple_less_equal_elem
测试一个元组在元素上是否小于或等于另一个元组。
tuple_not_equal
测试两个元组是否不相等。
tuple_not_equal_elem
测试两个元组在元素上是否不相等。
28.4 Conversion, 转换
操作符列表
handle_to_integer
将句柄转换为整数。
integer_to_handle
将整数转换为句柄。
tuple_chr
将整数元组转换为字符串。
tuple_chrt
将整数元组转换为字符串。
tuple_int
将元组转换为整数元组。
tuple_is_number
检查元组(字符串)是否表示数字。
tuple_number
将元组(字符串)转换为数字元组。
tuple_ord
将长度为1的字符串元组转换为整数元组。
tuple_ords
将字符串元组转换为整数元组。
tuple_real
将元组转换为浮点数元组。
tuple_round
将元组转换为整数元组。
tuple_string
将元组转换为字符串元组。
28.5 Creation, 创建
操作符列表
clear_handle
清除句柄的内容。
tuple_concat
将两个元组连接到一个新元组。
tuple_gen_const
生成特定长度的元组并初始化其元素。
tuple_gen_sequence
生成一个具有等距值序列的元组。
tuple_rand
返回0到1之间的随机数元组。
28.6 Data Containers, 数据容器
操作符列表
copy_dict
拷贝一个字典。
create_dict
创建一个新的空字典。
get_dict_object
从字典中检索与键关联的对象。
get_dict_param
查询字典参数或字典相关信息。
get_dict_tuple
从字典中检索与键相关联的元组。
read_dict
从文件中读取字典。
remove_dict_key
从字典中删除键。
set_dict_object
向字典中添加一个键/对象对。
set_dict_tuple
向字典中添加一个键/元组对。
write_dict
将字典写入文件。
28.7 Element Order, 元素顺序
操作符列表
tuple_inverse
对元组求逆。
tuple_sort
对元组中的元素按升序排序。
tuple_sort_index
对元组的元素进行排序并返回已排序元组的索引。
28.8 Features, 特征
操作符列表
get_handle_object
从句柄中检索与键关联的对象。
get_handle_param
返回有关句柄的信息。
get_handle_tuple
从句柄中检索与键关联的元组。
tuple_deviation
返回元组元素的标准差。
tuple_histo_range
计算元组在一定值范围内的值分布。
tuple_length
返回元组的元素个数。
tuple_max
返回元组的最大元素。
tuple_mean
返回数字元组的平均值。
tuple_median
返回元组元素的中位数。
tuple_min
返回元组的最小元素。
tuple_sum
返回元组中所有元素的和。
28.9 Logical Operations, 逻辑运算
操作符列表
tuple_and
计算两个元组的逻辑和。
tuple_not
计算元组的逻辑非。
tuple_or
计算两个元组的逻辑或。
tuple_xor
计算两个元组的逻辑异或。
28.10 Manipulation, 操纵
操作符列表
tuple_insert
在索引处的元组中插入一个或多个元素。
tuple_remove
从元组中删除元素。
tuple_replace
替换元组中的一个或多个元素。
28.11 Selection
操作符列表
tuple_find
返回一个元组在另一个元组中出现的所有索引。
tuple_find_first
返回一个元组在另一个元组中的第一个出现的索引。
tuple_find_last
返回一个元组在另一个元组中最后出现的索引。
tuple_first_n
选择元组中直到索引“n”的第一个元素。
tuple_last_n
选择从索引“n”到元组末尾的所有元素。
tuple_select
选择元组中的单个元素。
tuple_select_mask
在掩码中选择元组的指定元素。
tuple_select_range
选择元组的几个元素。
tuple_select_rank
选择元组中排名第n的元素。
tuple_str_bit_select
从元组中选择单个字符或位。
tuple_uniq
丢弃元组中除一个元素外的所有连续相同元素。
28.12 Sets
操作符列表
tuple_difference
计算两个输入元组的差集。
tuple_intersection
计算两个输入元组的交集。
tuple_symmdiff
计算两个输入元组的对称差分集。
tuple_union
计算两个输入元组的并集。
28.13 String Operations (...)
本章包含字符串操作符。
28.13.1 一般信息
HALCON库默认使用UTF-8编码字符串。
UTF-8是一种Unicode字符编码，可以用一到四个字节编码所有Unicode码点。'Unicode'指的是将字符串的每个字符分配给代码点的字符集(例如，'U + 0041'表示' a ')。然后UTF-8将Unicode代码点转换为二进制数据。所有ASCII字符的内存要求通常为1字节。某些字符，如德语变音符(German umlauts)，或希腊(Greek)和西里尔(Cyrillic)字符需要2个字节。亚洲(Asian)字符每个字符最多占用4个字节。
默认情况下，HALCON字符串操作符基于Unicode代码点工作。也就是说，访问字符串中的字符总是返回该字符对应的Unicode码点，而不管在UTF-8中表示该码点需要多少字节。因此，可以在所有系统上统一翻译多字节字符，例如亚洲字符或德语的变音符。请注意，Unicode标准还允许您从多个代码点组合可打印字符(使用所谓的“组合变音符标记”)。HALCON目前还不完全支持这一点:在HALCON中，码点是单独处理的，当比较字符串时，如果用不同的码点编码，则等效字符不被设置为相等。
如果在执行旧程序期间存在兼容性问题，可以将HALCON库的字符串编码从'utf8'更改为'locale'(遗留模式)。然后，根据语言环境和字符串操作符的工作(与以前版本的HALCON一样)来存储字符串，不是按字符而是按字节。如果在UTF-8模式下还需要按字节进行字符处理，则可以使用操作符set_system将选项'tuple_string_operator_mode'从'codepoint'设置为'byte'。之后，字符串操作符不再基于代码点工作。例如，字符串的字节序列可能对于调试感兴趣。
28.13.2 操作符列表
tuple_environment
读取一个或多个环境变量。
tuple_regexp_match
使用正则表达式提取子字符串。
tuple_regexp_replace
使用正则表达式替换子字符串。
tuple_regexp_select
选择匹配正则表达式的元组元素。
tuple_regexp_test
测试字符串是否与正则表达式匹配。
tuple_split
使用预定义的分隔符将字符串拆分为子字符串。
tuple_str_first_n
从字符串元组中剪切到位置“n”的第一个字符。
tuple_str_last_n
从字符串元组中删除从位置“n”开始的所有字符。
tuple_strchr
前向搜索字符串元组中的字符。
tuple_strlen
确定字符串元组中每个字符串的长度。
tuple_strrchr
向后搜索字符串元组中的字符。
tuple_strrstr
向后搜索字符串元组中的字符串。
tuple_strstr
前向搜索字符串元组中的字符串。
tuple_substr
从字符串元组中从位置“n1”到“n2”剪切字符。
28.14 Type, 类型
操作符列表
tuple_is_handle
测试元组的内部表示是否为handle类型。
tuple_is_handle_elem
测试元组的元素是否为handle类型。
tuple_is_int
测试元组的内部表示是否为integer类型。
tuple_is_int_elem
测试元组元素的类型是否为integer类型。
tuple_is_mixed
测试元组是否为mixed类型。
tuple_is_real
测试元组的内部表示是否为real类型。
tuple_is_real_elem
测试元组元素的类型是否为real类型。
tuple_is_stringstring
测试元组的内部表示是否为string类型。
tuple_is_string_elem
测试元组元素的类型是否为string类型。
tuple_is_valid_handle
检查句柄是否有效。
tuple_sem_type
返回元组的语义类型。
tuple_sem_type_elem
返回元组元素的语义类型。
tuple_type
返回元组的类型。
tuple_type_elem
返回元组元素的类型。