tuple_numbertuple_numberTupleNumberTupleNumbertuple_number (Operator)

Name

tuple_numbertuple_numberTupleNumberTupleNumbertuple_number — Convert a tuple (of strings) into a tuple of numbers.

Signature

Description

tuple_numbertuple_numberTupleNumberTupleNumbertuple_number converts the input tuple TTTtt into a tuple of numbers. If the input tuple contains numbers, they are simply copied into the output tuple. Strings are converted into the appropriate type of number (integer or floating point numbers) or are copied as strings if they do not represent a number. Note that strings starting with 0x are interpreted as hexadecimal numbers, and strings starting with 0 as octal numbers. For example, the string '20' is converted to the integer 20, '020' to 16, and '0x20' to 32.

Exception: Empty input tuple

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

Exception: Out of range integers

If the input tuple contains strings with integers that cannot be represented as Hlong (32-bit signed integer for 32-bit HALCON, 64-bit signed integer for 64-bit HALCON), an exception is raised.

String padding

If tuple_numbertuple_numberTupleNumberTupleNumbertuple_number converts a string to a number, the same string with added leading and/or trailing spaces will be converted to the same number. Example: number('55.6') == 55.6 and number(' 55.6 ') == 55.6

HDevelop In-line Operation

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

Number := number(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

See also

tuple_is_numbertuple_is_numberTupleIsNumberTupleIsNumbertuple_is_number, tuple_stringtuple_stringTupleStringTupleStringtuple_string

Module

Foundation