tuple_number🔗
Short description🔗
tuple_number — Convert a tuple (of strings) into a tuple of numbers.
Signature🔗
tuple_number( tuple T, out tuple Number )
Description🔗
tuple_number converts the input tuple T 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_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_number,
which can be used in an expression in the following syntax:
Number := number(T)
Execution information🔗
Execution information
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Processed without parallelization.
Parameters🔗
T (input_control) tuple(-array) → (string / real / integer)
Input tuple.
Number (output_control) tuple(-array) → (real / integer / string)
Input tuple as numbers.
Combinations with other operators🔗
Module🔗
Foundation