《zw版·Halcon-delphi系列原创教程》 Halcon分类函数014,tuple，元组
为方便阅读，在不影响说明的前提下，笔者对函数进行了简化：
- :: 用符号“**”，替换：“procedure”
- :: 用大写字母“X”，替换：“IHUntypedObjectX”
- :: 省略了字符：“const”、“OleVariant”
【示例】 说明
函数：
procedure AddNoiseWhiteContourXld( const Contours: IHUntypedObjectX; out NoisyContours: IHUntypedObjectX; NumRegrPoints: OleVariant; Amp: OleVariant);
简化后为：
** AddNoiseWhiteContourXld( Contours: X; out NoisyContours: X; NumRegrPoints, Amp);
1 ** CountRelation( RelationName, out NumOfTuples); 2 说明, count_relation,在HALCON数据库中实体的数目。 3 4 ** DeserializeTuple( SerializedItemHandle, out Tuple); 5 说明, Tuple元组数据转换 6 7 ** IntegerToObj( out Objects: X; SurrogateTuple); 8 说明, integer_to_obj,将一个整型数转换为一个图标。 9 10 ** ObjToInteger( Objects: X; Index, Number, out SurrogateTuple); 11 说明, obj_to_integer,将一个图标转换为一个整型数。 12 13 ** ReadTuple( FileName, out Tuple); 14 说明, read_tuple,从一个文件中读取一个数组。 15 16 ** ReceiveTuple( Socket, out Tuple); 17 说明, receive_tuple,通过插口连接接收一个元组。 18 19 ** SendTuple( Socket, Tuple); 20 说明, send_tuple,通过插口连接发送一个元组。 21 22 ** SerializeTuple( Tuple, out SerializedItemHandle); 23 说明, tuple元组数据序列化 24 25 ** TupleAbs( T, out Abs); 26 说明, tuple_abs,计算一个元组的绝对值。 27 28 ** TupleAcos( T, out ACos); 29 说明, tuple_acos,计算一个元组的反余弦。 30 31 ** TupleAdd( S1, S2, out Sum); 32 说明, tuple_add,两个元组相加。 33 34 ** TupleAnd( T1, T2, out And_); 35 说明, tuple_and,两个元组的逻辑与。 36 37 ** TupleAsin( T, out ASin); 38 说明, tuple_asin,计算一个元组的反余弦。 39 40 ** TupleAtan( T, out ATan); 41 说明, tuple_atan,计算一个元组的反正切。 42 43 ** TupleAtan2( Y, X, out ATan); 44 说明, tuple_atan2,计算一个元组四个象限的反正切。 45 46 ** TupleBand( T1, T2, out BAnd); 47 说明, tuple_band,计算两个元组的按位运算。 48 49 ** TupleBnot( T, out BNot); 50 说明, tuple_bnot,两个元组逐位取逻辑非。 51 52 ** TupleBor( T1, T2, out BOr); 53 说明, tuple_bor,计算两个元组的按位运算。 54 55 ** TupleBxor( T1, T2, out BXor); 56 说明, tuple_bxor,两个元组逐位进行互斥逻辑或运算。 57 58 ** TupleCeil( T, out Ceil); 59 说明, tuple_ceil,计算一个元组的上限函数。 60 61 ** TupleChr( T, out Chr); 62 说明, tuple_chr,根据ASCII码将整型元组转换为字符串。 63 64 ** TupleChrt( T, out Chrt); 65 说明, tuple_chrt,根据ASCII码将整型元组转换为字符串。 66 67 ** TupleConcat( T1, T2, out Concat); 68 说明, tuple_concat,合并两个元组为一个新的。 69 70 ** TupleCos( T, out Cos); 71 说明, tuple_cos,计算一个元组的余弦。 72 73 ** TupleCosh( T, out Cosh); 74 说明, tuple_cosh,计算一个元组的双曲余弦。 75 76 ** TupleCumul( Tuple, out Cumul); 77 说明, tuple_cumul,计算一个元组的累计和。 78 79 ** TupleDeg( Rad, out Deg); 80 说明, tuple_deg,将一个元组从弧度转换为角度。 81 82 ** TupleDeviation( Tuple, out Deviation); 83 说明, tuple_deviation,返回一个元组元素的标准差。 84 85 ** TupleDiv( Q1, Q2, out Quot); 86 说明, tuple_div,将两个元组相除。 87 88 ** TupleEnvironment( Names, out Values); 89 说明, tuple_environment,读取一个或多个环境变量。 90 91 ** TupleEqual( T1, T2, out Equal); 92 说明, tuple_equal,测试两个元组是否相同。 93 94 ** TupleEqualElem( T1, T2, out Equal); 95 说明, 测试两个元组元素是否相同。 96 97 ** TupleExp( T, out Exp); 98 说明, tuple_exp,元组的指数运算。 99 100 ** TupleFabs( T, out Abs); 101 说明, tuple_fabs,计算一个元组（例如浮点数）的绝对值。 102 103 ** TupleFind( Tuple, ToFind, out Indices); 104 说明, tuple_find,返回一个元组所有出现的符号，同时位于另一个元组内。 105 106 ** TupleFirstN( Tuple, Index, out Selected); 107 说明, tuple_first_n,选取一个元组的第一个元素。 108 109 ** TupleFloor( T, out Floor); 110 说明, tuple_floor,计算一个元组的地板函数”。 111 112 ** TupleFmod( T1, T2, out Fmod); 113 说明, tuple_fmod,计算两个元组浮点数相除的余数。 114 115 ** TupleGen( Length, _, out Newtuple); 116 说明, tuple_gen_const,创建一个特殊长度的元组和初始化它的元素。 117 118 ** TupleGenSequence( Start, End_, Step, out Sequence); 119 说明, 创建等序化的元组和初始化它的元素。 120 121 ** TupleGreater( T1, T2, out Greater); 122 说明, tuple_greater,测试一个元组是否大于另一个元组。 123 124 ** TupleGreaterElem( T1, T2, out Greater); 125 说明, 测试一个元组元素是否大于等于另一个。 126 127 ** TupleGreaterEqual( T1, T2, out Greatereq); 128 说明, tuple_greater_equal,测试一个元组是否大于等于另一个。 129 130 ** TupleGreaterEqualElem( T1, T2, out Greatereq); 131 说明, 测试一个元组元素是否等于另一个。 132 133 ** TupleHistoRange( Tuple, Min, Max, NumBins, out Histo, out BinSize); 134 说明, 元组直方图 135 136 ** TupleInsert( Tuple, Index, InsertTuple, out Extended); 137 说明, 元组插入 138 139 ** TupleInt( T, out Int); 140 说明, tuple_int,讲一个元组转换为一个整型元组。 141 142 ** TupleInverse( Tuple, out Inverted); 143 说明, tuple_inverse,将一个元组反置（反转）。 144 145 ** TupleIsInt( T, out IsInt); 146 说明, 元组整数测试 147 148 ** TupleIsIntElem( T, out IsInt); 149 说明, 元组元素整数测试 150 151 ** TupleIsMixed( T, out IsMixed); 152 说明, 元组混合测试 153 154 ** TupleIsNumber( T, out IsNumber); 155 说明, tuple_is_number,检测一个字符串元组是否表示数字。 156 157 ** TupleIsReal( T, out IsReal); 158 说明, 元组实数测试 159 160 ** TupleIsRealElem( T, out IsReal); 161 说明, 元组元素实数测试 162 163 ** TupleIsString( T, out IsString); 164 说明, 元组字符串测试 165 166 ** TupleIsStringElem( T, out IsString); 167 说明, 元组元素字符串测试 168 169 ** TupleLastN( Tuple, Index, out Selected); 170 说明, tuple_last_n,选择从符号n”开始到元组末尾的所有元素。 171 172 ** TupleLdexp( T1, T2, out Ldexp); 173 说明, tuple_ldexp,计算两个元组的返回长双精度指数函数。 174 175 ** TupleLength( Tuple, out Length); 176 说明, tuple_length,返回一个元组元素数目。 177 178 ** TupleLess( T1, T2, out Less); 179 说明, tuple_less,测试一个元组是否小于另一个元组。 180 181 ** TupleLessElem( T1, T2, out Less); 182 说明, 测试一个元组元素是否小于另一个元组。 183 184 ** TupleLessEqual( T1, T2, out Lesseq); 185 说明, tuple_less_equal,测试一个元组是否小于等于另一个。 186 187 ** TupleLessEqualElem( T1, T2, out Lesseq); 188 189 ** TupleLog( T, out Log); 190 说明, tuple_log,计算一个元组的自然对数。 191 192 ** TupleLog10( T, out Log); 193 说明, tuple_log10,计算一个元组底为10的对数。 194 195 ** TupleLsh( T, Shift, out Lsh); 196 说明, tuple_lsh,元组逐位左移。 197 198 ** TupleMax( Tuple, out Max); 199 说明, tuple_max,返回一个元组的最大元素。 200 201 ** TupleMax2( T1, T2, out Max2); 202 说明, tuple_max2,计算两个元组的元素宽度的最大值。 203 204 ** TupleMean( Tuple, out Mean); 205 说明, tuple_mean,返回一定数量元组的平均值。 206 207 ** TupleMedian( Tuple, out Median); 208 说明, tuple_median,返回一个元组元素的中值。 209 210 ** TupleMin( Tuple, out Min); 211 说明, tuple_min,返回一个元组的最小元素。 212 213 ** TupleMin2( T1, T2, out Min2); 214 说明, tuple_min2,计算两个元组的元素宽度的最小值。 215 216 ** TupleMod( T1, T2, out Mod_); 217 说明, tuple_mod,计算两个元组整型数相除的余数。 218 219 ** TupleMult( P1, P2, out Prod); 220 说明, tuple_mult,两个元组相乘。 221 222 ** TupleNeg( T, out Neg); 223 说明, tuple_neg,将一个元组取反。 224 225 ** TupleNot( T, out Not_); 226 说明, tuple_not,两个元组的逻辑非。 227 228 ** TupleNotEqual( T1, T2, out Nequal); 229 说明, tuple_not_equal,测试两个元组是不是不等。 230 231 ** TupleNotEqualElem( T1, T2, out Nequal); 232 说明, 测试两个元组元素是不是不等。 233 234 ** TupleNumber( T, out Number); 235 说明, tuple_number,将一个字符串元组转换为一个数字元组。 236 237 ** TupleOr( T1, T2, out Or_); 238 说明, tuple_or,两个元组的逻辑或。 239 240 ** TupleOrd( T, out Ord); 241 说明, tuple_ord,将长度为1的字符串的元组转换为它们相应的ASCII码元组。 242 243 ** TupleOrds( T, out Ords); 244 说明, tuple_ords,将一个字符串的元组转换为它们ASCII码的元组。 245 246 ** TuplePow( T1, T2, out Pow); 247 说明, tuple_pow,计算两个元组的冥函数。 248 249 ** TupleRad( Deg, out Rad); 250 说明, tuple_rad,将一个元组从角度转换为弧度。 251 252 ** TupleRand( Length, out Rand); 253 说明, tuple_rand,返回任意值为0或1的元组。 254 255 ** TupleReal( T, out Real); 256 说明, tuple_real,将一个元组转换为一个浮点数的元组。 257 258 ** TupleRegexpMatch( Data, Expression, out Matches); 259 说明, tuple_regexp_match,利用公式提取子链。 260 261 ** TupleRegexpReplace( Data, Expression, Replace, out Result); 262 说明, tuple_regexp_replace,用有规律的公式代替一个子链。 263 264 ** TupleRegexpSelect( Data, Expression, out Selection); 265 说明, tuple_regexp_select,选择符合公式的元组元素。 266 267 ** TupleRegexpTest( Data, Expression, out NumMatches); 268 说明, tuple_regexp_test,测试一个字符串是否满足一个规则公式的要求。 269 270 ** TupleRemove( Tuple, Index, out Reduced); 271 说明, tuple_remove,从一个元组中移出元素。 272 273 ** TupleReplace( Tuple, Index, ReplaceTuple, out Replaced); 274 说明, 元组替换 275 276 ** TupleRound( T, out Round); 277 说明, tuple_round,将一个元组转换为一个整型数的元组。 278 279 ** TupleRsh( T, Shift, out Rsh); 280 说明, tuple_rsh,元组逐位右移。 281 282 ** TupleSelect( Tuple, Index, out Selected); 283 说明, tuple_select,选择一个元组中单一元素。 284 285 ** TupleSelectMask( Tuple, Mask, out Selected); 286 说明, 选择元组掩码 287 288 ** TupleSelectRange( Tuple, Leftindex, Rightindex, out Selected); 289 说明, tuple_select_range,选择一个元组中的一些元素。 290 291 ** TupleSelectRank( Tuple, RankIndex, out Selected); 292 说明, tuple_select_rank,选择一个元组中序号为n的元素。 293 294 ** TupleSgn( T, out Sgn); 295 说明, tuple_sgn,计算一个元组的正负。 296 297 ** TupleSin( T, out Sin); 298 说明, tuple_sin,计算一个元组的正弦。 299 300 ** TupleSinh( T, out Sinh); 301 说明, tuple_sinh,计算一个元组的双曲正弦。 302 303 ** TupleSort( Tuple, out Sorted); 304 说明, tuple_sort,按照升序分类（排列）元组的元素。 305 306 ** TupleSortIndex( Tuple, out Indices); 307 说明, tuple_sort_index,将元组的元素分类并返回分类元组的目录。 308 309 ** TupleSplit( String_, Separator, out Substrings); 310 说明, tuple_split,在预定义的独立字符间将字符串分离为子链。 311 312 ** TupleSqrt( T, out Sqrt); 313 说明, tuple_sqrt,计算一个元组的平方根（二次方根）。 314 315 ** TupleStrBitSelect( Tuple, Index, out Selected); 316 说明, tuple_str_bit_select,选择一个元组中单一符号或位。 317 318 ** TupleStrchr( String_, ToFind, out Position); 319 说明, tuple_strchr,前向搜索一个位于字符串元组内的字符。 320 321 ** TupleStrFirstN( String_, Position, out Substring); 322 说明, tuple_str_first_n,分割从第一个字符直到字符串元组外的位置n”处。 323 324 ** TupleString( T, Format, out String_); 325 说明, tuple_string,将一个元组转换为一个字符串元组。 326 327 ** TupleStrLastN( String_, Position, out Substring); 328 说明, tuple_str_last_n,从字符串元组外位置n”处开始分割所有的字符。 329 330 ** TupleStrlen( T1, out Length); 331 说明, tuple_strlen,字符串元组中每个字符串的长度。 332 333 ** TupleStrrchr( String_, ToFind, out Position); 334 说明, tuple_strrchr,后向搜索一个位于字符串元组内的字符。 335 336 ** TupleStrrstr( String_, ToFind, out Position); 337 说明, tuple_strrstr,后向搜索一个位于字符串元组内的字符串。 338 339 ** TupleStrstr( String_, ToFind, out Position); 340 说明, tuple_strstr,前向搜索一个位于字符串元组内的字符串。 341 342 ** TupleSub( D1, D2, out Diff); 343 说明, tuple_sub,两个元组相减。 344 345 ** TupleSubstr( String_, Position1, Position2, out Substring); 346 说明, 两个元组字符串相减。 347 348 ** TupleSum( Tuple, out Sum); 349 说明, tuple_sum,返回一个元组所有元素的和。 350 351 ** TupleTan( T, out Tan); 352 说明, tuple_tan,计算一个元组的正切。 353 354 ** TupleTanh( T, out Tanh); 355 说明, tuple_tanh,计算一个远足的双曲正切。 356 357 ** TupleType( T, out Type_); 358 说明, 两个元组类型 359 360 ** TupleTypeElem( T, out Types); 361 说明, 两个元组元素类型 362 363 ** TupleUniq( Tuple, out Uniq); 364 说明, tuple_uniq,丢弃元组中除成功归类的元素外的所有元素。 365 366 ** TupleXor( T1, T2, out Xor_); 367 说明, tuple_xor,两个元组的逻辑互斥或。 368 369 ** WriteTuple( Tuple, FileName); 370 说明, write_tuple,向一个文件中写入一个数组。