Halcon Tuple相关算子(一)

(1) tuple_length( : : Tuple : Length)

功能：返回输入元组中元素的个数。

控制输入参数： Tuple：输入元组；

控制输出参数：length：输入元组中元素的个数。

(2) tuple_find( : : Tuple, ToFind : Indices)

功能：返回ToFind元组在Tuple元组中出现的索引,索引值从0开始。

说明：如果第二个元组ToFind不是第一个元组Tuple的子元组，则返回的索引值为-1。

控制输入参数：Tuple：输入要检查的元组；

控制输入参数：ToFind：输入要查找的子元组；

控制输出参数：Indexs：ToFind元组在Tuple元组中查找到的索引值。

(3) tuple_find_first( : : Tuple, ToFind : Index)

功能：返回ToFind元组在Tuple元组中第一次出现的索引,索引值从0开始。

说明：如果第二个元组ToFind不是第一个元组Tuple的子元组，则返回的索引值为-1。

控制输入参数：Tuple：输入要检查的元组；

控制输入参数：ToFind：输入要查找的子元组；

控制输出参数：Index：要查找的值第一次出现的索引。

(4) tuple_find_last( : : Tuple, ToFind : Index)

功能：返回ToFind元组在Tuple元组中最后一次出现的索引,索引值从0开始。

说明：如果第二个元组ToFind不是第一个元组Tuple的子元组，则返回的索引值为-1。

控制输入参数：Tuple：输入要检查的元组；

控制输入参数：ToFind：输入要查找的子元组；

控制输出参数：Index：要查找的值最后一次出现的索引。

(5) tuple_first_n( : : Tuple, Index : Selected)

功能：返回由Tuple中第0个元素(索引为0)~第n个元素(索引为Index)组成的子元组。

控制输入参数：Tuple：输入元组；

控制输入参数：Index：选择最后一个元素的索引；

控制输出参数：Selected：选定的子元组。

(6) tuple_last_n( : : Tuple, Index : Selected)

功能：返回由Tuple中第n个元素(索引为Index)~最后一个元素(索引为)组成的子元组。

控制输入参数：Tuple：输入元组；

控制输入参数：Index：选择第一个元素的索引；

控制输出参数：Selected：选定的子元组。

(7) tuple_select( : : Tuple, Index : Selected)

功能：返回元组中的索引为Index的单个或多个元素。

控制输入参数：Tuple：输入元组；

控制输入参数：Index：要选择的元素索引；

控制输出参数：Selected：选定的子元组。

(8) tuple_select_range( : : Tuple, Leftindex, Rightindex : Selected)

功能：返回tuple中索引值为[Leftindex,Rightindex]的连续个元素。

控制输入参数：Tuple：输入元组；

控制输入参数：Leftindex：选择的第一个元素的索引；

控制输入参数：Rightindex：选择的最后一个元素的索引；

控制输出参数：Selected：选定的子元组。

(9) tuple_remove( : : Tuple, Index : Reduced)

功能：从元组tuple中移除一个或多个元素，并返回由其余元素组成的元组。

控制输入参数：Tuple：输入元组；

控制输入参数：Index：要删除的元素的索引；

控制输出参数：Reduced：删除后剩余的元组。

(10) tuple_gen_const( : : Length, Const : Newtuple)

功能：在Newtuple中生成一个长度Length，元素为 Const新的元组。

控制输入参数：Length：待生成的元组长度；

控制输入参数：Const：用于初始化元组元素的常量；

控制输出参数：Newtuple：新生成的元组。

(11) tuple_deg( : : Rad : Deg)

功能：将元组中的弧度值转化为角度值。

控制输入参数：Rad: 输入的弧度值；

控制输出参数：Deg: 转化后的角度值。

(12) tuple_split( : : String, Separator : Substrings)

功能：将字符串拆分为由分隔符分割的子字符串。      

控制输入参数：String: 字符串输入元组；

控制输入参数：Separator: 分隔符；

控制输出参数：Substrings: 输入字符串被拆分后的子字符串。