Guardian Procedure Calls Reference Manual

NUMIN Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The NUMIN procedure converts the ASCII characters used to represent a number into the signed
integer value for that number.
Syntax for C Programmers
#include <cextdecs(NUMIN)>
short NUMIN ( char *ascii-num
,short _near *signed-result
,short base
,short _near *status );
Syntax for TAL Programmers
next-addr := NUMIN ( ascii-num ! i
,signed-result ! o
,base ! i
,status ); ! o
Parameters
ascii-num
input
STRING:ref:*
is an array containing the number to be converted to signed integer form. ascii-num is of
the form:
number nonnumeric[ h/H ][ % ][ + ]
[ b/B ][ - ]
where "%" means treat the number as a binary, octal, or hexadecimal value (as indicated)
regardless of the specified base. Note that nonnumeric applies only to hexadecimal values.
signed-result
output
INT:ref:1
returns the result of the conversion.
base
input
INT:value
specifies the number base of ascii-num. Legitimate values are 2 through 10 and 16.
NUMIN Procedure 883