Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-85
DNUMIN Procedure
ascii-number input
STRING .EXT:ref:*
is an array containing the number to be converted to signed double word integer
form.
ascii-number is of the form:
[ + ] [ prefix ] number nonnumeric
[ - ]
where any of the following prefix values can be used to override the specified
base:
%octal
#decimal
%b or %B binary
%h or %H hexadecimal
The
number cannot contain embedded commas.
signed-result output
INT(32) .EXT:ref:1
returns the signed double word integer result of the conversion.
base input
INT:value
specifies the number base of
ascii-number. Legitimate values are 2 through 36.
Note that supplying a
prefix in ascii-number overrides this specification.
status output
INT .EXT:ref:1
returns a number that indicates the outcome of the conversion.
The values for
status are:
1 Nonexistent number (string does not start with a valid sign, prefix, or numeric)
0 Valid conversion
-1 Illegal integer (number cannot be represented in 32 bits as a signed quantity)
flags input
INT:value
can be used to alter the number format accepted by DNUMIN as follows:
<0:12> Must be 0
<13> Disallow preceding sign (+/-)