ISO2002ENTMF 

The NUMVAL-F Function

The NUMVAL-F function returns the numeric value represented by the alphanumeric character string or national character string specified by argument-1. Leading or trailing spaces in the string are removed from the resulting numeric value.

The type of the function is numeric.

General Format

Syntax for the NUMVAL-F function

Arguments

  1. argument-1 must be an alphanumeric or national literal, or a data item of class type alphanumeric or national that conforms to the following format:
    >>-.-------.--.-----.--.-------.--.-digit-.--------------.-.--->
       +-space-+  +- + -+  +-space-+  |       +-.--.-------.-+ |
                  +- - -+             |            +-digit-+   |
                                      +-.--digit---------------+
    
    >--.-------.--------------------------------------------------->
       +-space-+
    
    >--.-------------------------------------------------------.---><
       +-E--.-------.--.- + -.--.--------------.--n--.-------.-+
            +-space-+  +- - -+  +-space-string-+     +-space-+

    where:

    space
    A string of one or more spaces.
    digit
    A string of one or more digits. If the exponent clause is specified, the mantissa must not exceed 16 digits.
    n
    The exponent value, which is a 1-4 digit-string.
    E
    If argument-1 is alphanumeric, E must be either an uppercase or lowercase E character; if argument-1 is national, E must be either an uppercase or lowercase E national character.

    If the DECIMAL-POINT IS COMMA clause is specified in the SPECIAL-NAMES paragraph, you must specify a comma in argument-1, and not a decimal point.

Returned Values

  1. The returned value is a floating-point approximation of the numeric value represented by argument-1.