tuple_ord🔗
Short description🔗
tuple_ord — Convert a tuple of strings of length 1 into a tuple of integer numbers.
Signature🔗
tuple_ord( string T, out integer Ord )
Description🔗
tuple_ord converts the input tuple T, which may only contain
strings of length 1, 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 accepts the UTF-8 representation of a
Unicode character (code point) and returns the appropriate Unicode character
code.
When the HALCON library encoding is set to 'locale' or the string
operator mode is 'byte', the operator accepts only a single byte for
each input string.
In that case the operator tuple_ord returns the ANSI code of the
input byte as integer number between 0 and 256.
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_ord,
which can be used in an expression in the following syntax:
Ord := ord(T)
Execution information🔗
Execution information
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Processed without parallelization.
Parameters🔗
T (input_control) string(-array) → (string)
Input tuple with strings of length 1.
Ord (output_control) integer(-array) → (integer)
Output tuple with Unicode character codes or ANSI codes of the characters passed in the input tuple.
Combinations with other operators🔗
Module🔗
Foundation