3.6.13 STRTONUM

STR.STRTONUM(s, radix, lastp) ! Str,Num,Vec => Num

Compute the value represented by the numeric literal stored in the string 's'. 'Radix' specifies the base of the literal in 's'. It may range from '2' (binary) to '16' (hexa-decimal).

STRTONUM performs the following steps:

• Leading TAB ('\t') and space ('\s') characters in 's' are skipped.
• A plus (+) or minus (-,%) sign is recognized.
• Characters belonging to the specified literal class (based upon 'radix') are collected and converted into a numeric value.

The following characters may represent the digits from 0 to 15: "0123456789ABCDEF". Alternatively, the digits 10 through 15 may be represented by the lower case characters "abcdef".

When the argument 'lastp' is non-zero, it will be filled with the number of characters processed. Subsequently, it contains the position of the first non-numeric character in 's' when STRTONUM returns.

No overflow checking is performed. STRTONUM returns the computed value.

See also: NUMTOSTR, PARSE