VMS Help
RTL Routines, OTS$, OTS$CVT_L_TO
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
The Convert Unsigned Integer to Octal Text routine converts an
unsigned integer to an octal ASCII text string. OTS$CVT_L_TO
supports Fortran Ow and Ow.m output conversion formats.
Format
OTS$CVT_L_TO varying-input-value
,fixed-length-resultant-string
[,number-of-digits] [,input-value-size]
OpenVMS usage:cond_value
type: longword (unsigned)
access: write only
mechanism: by value
varying-input-value
OpenVMS usage:varying_arg
type: unspecified
access: read only
mechanism: by reference
Unsigned byte, word, or longword that OTS$CVT_L_TO converts to
an unsigned decimal representation in an ASCII text string.
(The value of the input-value-size argument determines whether
varying-input-value is a byte, word, or longword.) The varying-
input-value argument is the address of the unsigned integer.
fixed-length-resultant-string
OpenVMS usage:char_string
type: character string
access: write only
mechanism: by descriptor, fixed length
Output string that OTS$CVT_L_TO creates when it converts the
integer value to an octal ASCII text string. The fixed-length-
resultant-string argument is the address of a descriptor pointing
to the octal ASCII text string. The string is assumed to be of
fixed length (CLASS_S descriptor).
number-of-digits
OpenVMS usage:longword_signed
type: longword (signed)
access: read only
mechanism: by value
Minimum number of digits that OTS$CVT_L_TO generates when it
converts the integer value to an octal ASCII text string. The
number-of-digits argument is a signed longword containing the
minimum number of digits. If it is omitted, the default is 1. If
the actual number of significant digits in the octal ASCII text
string is less than the minimum number of digits, OTS$CVT_L_TO
inserts leading zeros into the output string. If number-of-digits
is 0 and varying-input-value is 0, OTS$CVT_L_TO writes a blank
string to the output string.
input-value-size
OpenVMS usage:longword_signed
type: longword (signed)
access: read only
mechanism: by value
Size of the integer to be converted, in bytes. The input-value-
size argument is a signed longword containing the number of bytes
in the integer to be converted by OTS$CVT_L_TO. If it is omitted,
the default is 4 (longword).
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.