tuple_ordstuple_ordsTupleOrdsTupleOrdstuple_ords (Operator)

Name

tuple_ordstuple_ordsTupleOrdsTupleOrdstuple_ords — Convert a tuple of strings into a tuple of integer numbers.

Signature

tuple_ords( : : T : Ords)

Herror tuple_ords(const char* T, Hlong* Ords)

Herror T_tuple_ords(const Htuple T, Htuple* Ords)

void TupleOrds(const HTuple& T, HTuple* Ords)

HTuple HTuple::TupleOrds() const

static void HOperatorSet.TupleOrds(HTuple t, out HTuple ords)

HTuple HTuple.TupleOrds()

def tuple_ords(t: MaybeSequence[Union[str, int]]) -> Sequence[int]

def tuple_ords_s(t: MaybeSequence[Union[str, int]]) -> int

Description

tuple_ordstuple_ordsTupleOrdsTupleOrdsTupleOrdstuple_ords converts the input tuple TTTTtt, 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')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 returns for the input strings the appropriate Unicode character codes. 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 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_serialwrite_serialWriteSerialWriteSerialWriteSerialwrite_serial. In particular, a byte with value 0 can be written by inserting the integer number 0 into TTTTtt.

If the input tuple is empty, the operator returns an empty tuple.

HDevelop In-line Operation

HDevelop provides an in-line operation for tuple_ordstuple_ordsTupleOrdsTupleOrdsTupleOrdstuple_ords, which can be used in an expression in the following syntax:

Ords := ords(T)

Execution Information

Parameters

TTTTtt (input_control)  string(-array) HTupleMaybeSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Input tuple with strings.

OrdsOrdsOrdsOrdsordsords (output_control)  integer(-array) HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Output tuple with the Unicode character codes or ANSI codes of the input string.

Example (HDevelop)

tuple_ords (['String 1', 0, 'String 2', 0], Data)
write_serial (SerialHandle, Data)

Alternatives

tuple_ordtuple_ordTupleOrdTupleOrdTupleOrdtuple_ord

See also

tuple_chrtuple_chrTupleChrTupleChrTupleChrtuple_chr, tuple_chrttuple_chrtTupleChrtTupleChrtTupleChrttuple_chrt, write_serialwrite_serialWriteSerialWriteSerialWriteSerialwrite_serial

Module

Foundation