tuple_ords — Convert a tuple of strings into a tuple of integer numbers.
tuple_ords converts the input tuple T, which may
only contain strings and integer numbers, into a tuple of integer
numbers.
When the encoding used in the HALCON library is UTF-8 (see
set_system('filename_encoding', 'utf8')) and the string operators
are set to work by code points (see
set_system('tuple_string_operator_mode', 'codepoint')), which is the
default for both, the operator returns for the input strings the appropriate
Unicode character codes.
When the HALCON library encoding is set to 'locale' or the string
operator mode is 'byte', the operator returns the ANSI code for
every byte of the input string.
In that mode, the result may depend on the currently used code page for
strings that contain non-ASCII characters.
See also Tuple / String Operations for a more detailed description
of the different modes and further encoding issues.
The character codes of the individual strings are written to the output
according to their order within the string and within the tuple.
Integer numbers are simply copied to an appropriate position in the
output tuple.
This operator can be used to prepare outputs with write_serial.
In particular, a byte with value 0 can be written by inserting the integer
number 0 into T.
If the input tuple is empty, the operator returns an empty tuple.
HDevelop provides an in-line operation for tuple_ords,
which can be used in an expression in the following syntax:
T (input_control) string(-array) → (string / integer)
Input tuple with strings.
Ords (output_control) integer(-array) → (integer)
Output tuple with the Unicode character codes or ANSI codes of the input string.
tuple_ords (['String 1', 0, 'String 2', 0], Data) write_serial (SerialHandle, Data)
tuple_chr,
tuple_chrt,
write_serial
Foundation