tuple_ordtuple_ordTupleOrdTupleOrd (Operator)

Name

tuple_ordtuple_ordTupleOrdTupleOrd — Convert a tuple of strings of length 1 into a tuple of integer numbers.

Signature

tuple_ord( : : T : Ord)

Herror tuple_ord(const char* T, Hlong* Ord)

Herror T_tuple_ord(const Htuple T, Htuple* Ord)

void TupleOrd(const HTuple& T, HTuple* Ord)

HTuple HTuple::TupleOrd() const

static void HOperatorSet.TupleOrd(HTuple t, out HTuple ord)

HTuple HTuple.TupleOrd()

Description

tuple_ordtuple_ordTupleOrdTupleOrdTupleOrd converts the input tuple TTTTt, 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")) 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 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" or the string operator mode is 'byte'"byte""byte""byte""byte", the operator accepts only a single byte for each input string. In that case the operator tuple_ordtuple_ordTupleOrdTupleOrdTupleOrd 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_ordTupleOrdTupleOrdTupleOrd, which can be used in an expression in the following syntax:

Ord := ord(T)

Execution Information

Parameters

TTTTt (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Input tuple with strings of length 1.

OrdOrdOrdOrdord (output_control)  integer(-array) HTupleHTupleHtuple (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_ordsTupleOrdsTupleOrdsTupleOrds

See also

tuple_chrtuple_chrTupleChrTupleChrTupleChr, tuple_chrttuple_chrtTupleChrtTupleChrtTupleChrt

Module

Foundation