tuple_chrtuple_chrTupleChrTupleChr (Operator)

Name

tuple_chrtuple_chrTupleChrTupleChr — Convert a tuple of integer numbers into strings.

Signature

tuple_chr( : : T : Chr)

Herror tuple_chr(const Hlong T, char* Chr)

Herror T_tuple_chr(const Htuple T, Htuple* Chr)

void TupleChr(const HTuple& T, HTuple* Chr)

HTuple HTuple::TupleChr() const

static void HOperatorSet.TupleChr(HTuple t, out HTuple chr)

HTuple HTuple.TupleChr()

Description

tuple_chrtuple_chrTupleChrTupleChrTupleChr converts the input tuple TTTTt, consisting of integer numbers, into a tuple of strings, each of length 1. When the encoding used in the HALCON library is UTF-8 (see set_system('filename_encoding', 'utf8')set_system("filename_encoding", "utf8")SetSystem("filename_encoding", "utf8")SetSystem("filename_encoding", "utf8")SetSystem("filename_encoding", "utf8")) and the string operators are set to work by code points (see set_system('tuple_string_operator_mode', 'codepoint')set_system("tuple_string_operator_mode", "codepoint")SetSystem("tuple_string_operator_mode", "codepoint")SetSystem("tuple_string_operator_mode", "codepoint")SetSystem("tuple_string_operator_mode", "codepoint")), which is the default for both, the operator accepts Unicode character codes and returns strings with the appropriate UTF-8 representations of the characters. When the HALCON library encoding is set to 'locale'"locale""locale""locale""locale" or the string operator mode is 'byte'"byte""byte""byte""byte", the operator accepts only numbers between 0 and 256. In that case the operator tuple_chrtuple_chrTupleChrTupleChrTupleChr returns strings with one byte length each, where the input number is set as ANSI code. See also Tuple / String Operations for a more detailed description of the different modes and further encoding issues.

If the input tuple is empty, the operator returns an empty tuple.

HDevelop In-line Operation

HDevelop provides an in-line operation for tuple_chrtuple_chrTupleChrTupleChrTupleChr, which can be used in an expression in the following syntax:

Chr := chr(T)

Execution Information

Parameters

TTTTt (input_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Input tuple with Unicode character codes or ANSI codes.

Restriction: 0 <= T

ChrChrChrChrchr (output_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Output tuple with strings built from the character codes in the input tuple.

Alternatives

tuple_chrttuple_chrtTupleChrtTupleChrtTupleChrt

See also

tuple_ordtuple_ordTupleOrdTupleOrdTupleOrd, tuple_ordstuple_ordsTupleOrdsTupleOrdsTupleOrds

Module

Foundation