tuple_ordtuple_ordTupleOrdTupleOrdtuple_ord (Operator)


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


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()

def tuple_ord(t: MaybeSequence[str]) -> Sequence[int]

def tuple_ord_s(t: MaybeSequence[str]) -> int


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


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.



See also

tuple_chrtuple_chrTupleChrTupleChrTupleChrtuple_chr, tuple_chrttuple_chrtTupleChrtTupleChrtTupleChrttuple_chrt