Guardian Procedure Calls Reference Manual

status
output
INT:ref:1
returns a number that indicates the outcome of the conversion. The values for status are:
Nonexistent number (string does not start with "+," "-," "%," or numeric).1
Valid conversion.0
Invalid integer (number cannot be represented in 15 bits) or bad character in ascii-num.-1
Returned Value
BADDR
‘G'[0] relative string address of the first character in ascii-num not used in the conversion.
Considerations
• When number conversion stops
Number conversion stops on the first ASCII numeric character representing a value greater
than base -1 or a nonnumeric ASCII character.
• Base-10 numeric value range
Base-10 numeric values must be in the range of -32768 through 32767. Numeric values in
other number bases are accepted if they can be represented in 16 bits. Note that the magnitude
is computed first, so the value can then be negated (for example, %177777=-%1).
Related Programming Manual
For programming information about the NUMIN procedure, see the Guardian Programmer's Guide.
884 Guardian Procedure Calls (N)