Guardian Procedure Calls Reference Manual
Parameters
DNUMIN64_ has the same parameters as DNUMIN. The only difference is the data type of the
parameters. Pointers are explicitly 64-bits wide in DNUMIN64_.
ascii-number
input
(for DNUMIN)STRING .EXT:ref:*
(for DNUMIN64_)STRING .EXT64: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 these prefix values can be used to override the specified base:
octal%
decimal#
binary%b or %B
hexadecimal%h or %H
The number cannot contain embedded commas.
signed-result
output
(for DNUMIN)STRING .EXT:ref:1
(for DNUMIN64_)STRING .EXT64: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
(for DNUMIN)STRING .EXT:ref:*
(for DNUMIN64_)STRING .EXT64:ref:*
returns a number that indicates the outcome of the conversion.
The values for status are:
Nonexistent number (string does not start with a valid sign, prefix, or numeric).1
Valid conversion.0
Invalid integer (number cannot be represented in 32 bits as a signed quantity).-1
DNUMIN[64_] Procedures 323