The NUMVAL-C function returns the numeric value represented by the alphanumeric character string specified as argument-1. Any optional currency sign specified by argument-2 and any optional commas preceding the decimal point are stripped away, producing a numeric value that can be used in an arithmetic expression.
The NUMVAL-C function may not be specified under the following conditions:
The function type is numeric.
Format
>>-FUNCTION NUMVAL-C--(--argument-1-+------------+--)----------><
'-argument-2-'
>>-+-------+--+----+--+-------+--+----+--+-------+-------------->
'-space-' +-+--+ '-space-' '-cs-' '-space-'
'- --'
>--+-digit--+--------------+--+--------------+-+--+-------+----><
| | .----------. | '-.--+-------+-' | '-space-'
| | V | | '-digit-' |
| '---,--digit-+-' |
'-.--digit----------------------------------'
>>-+-------+--+----+--+-------+---------------------------------> '-space-' '-cs-' '-space-' >--+-digit--+--------------+--+--------------+-+--+-------+-----> | | .----------. | '-.--+-------+-' | '-space-' | | V | | '-digit-' | | '---,--digit-+-' | '-.--digit----------------------------------' >--+----+--+-------+------------------------------------------->< +-+--+ '-space-' +- --+ +-CR-+ '-DB-'
If the DECIMAL-POINT IS COMMA clause is specified in the SPECIAL-NAMES paragraph, the functions of the comma and decimal point in argument-1 are reversed.
If argument-2 is not specified, the character used for cs is the currency symbol specified for the program.
The returned value is an approximation of the numeric value represented by argument-1.
Related Information
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.