NUMS function

Syntax

NUMS (dynamic.array)
CALL -NUMS (return.array, dynamic.array)
CALL !NUMS (return.array, dynamic.array)

Description

Use the NUMS function to determine whether the elements of a dynamic array are numeric or nonnumeric strings. If an element is numeric, a numeric string, or an empty string, it evaluates to true, and a value of 1 is returned to the corresponding element in a new dynamic array. If the element is a nonnumeric string, it evaluates to false, and a value of 0 is returned.

The NUMS of a numeric element with a decimal point ( . ) evaluates to true; the NUMS of a numeric element with a comma ( , ) or dollar sign ( $ ) evaluates to false.

If dynamic.array evaluates to the null value, null is returned. If an element of dynamic.array is null, null is returned for that element.

If you use the subroutine syntax, the resulting dynamic array is returned as return.array.

If NLS is enabled, NUMS uses the Numeric category of the current locale to determine the decimal separator.