tuple_ordtuple_ordTupleOrdTupleOrdtuple_ord (Operator)
Name
tuple_ordtuple_ordTupleOrdTupleOrdtuple_ord — Convert a tuple of strings of length 1 into a tuple of integer numbers.
Signature
Herror tuple_ord(const char* T, Hlong* Ord)
Herror T_tuple_ord(const Htuple T, Htuple* Ord)
def tuple_ord(t: MaybeSequence[str]) -> Sequence[int]
def tuple_ord_s(t: MaybeSequence[str]) -> int
Description
tuple_ordtuple_ordTupleOrdTupleOrdTupleOrdtuple_ord converts the input tuple TTTTtt, 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')set_system("filename_encoding", "utf8")SetSystem("filename_encoding", "utf8")SetSystem("filename_encoding", "utf8")SetSystem("filename_encoding", "utf8")set_system("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")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'"locale""locale""locale""locale""locale" or the string
operator mode is 'byte'"byte""byte""byte""byte""byte", the operator accepts only a single byte for
each input string.
In that case the operator tuple_ordtuple_ordTupleOrdTupleOrdTupleOrdtuple_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_ordtuple_ordTupleOrdTupleOrdTupleOrdtuple_ord,
which can be used in an expression in the following syntax:
Ord := ord(T)
Execution Information
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
TTTTtt (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Input tuple with strings of length 1.
OrdOrdOrdOrdordord (output_control) integer(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Output tuple with Unicode character codes or ANSI codes of the
characters passed in the input tuple.
Alternatives
tuple_ordstuple_ordsTupleOrdsTupleOrdsTupleOrdstuple_ords
See also
tuple_chrtuple_chrTupleChrTupleChrTupleChrtuple_chr,
tuple_chrttuple_chrtTupleChrtTupleChrtTupleChrttuple_chrt
Module
Foundation