VMS Help
RTL Routines, OTS$, OTS$CVT_L_TZ
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
The Convert Integer to Hexadecimal Text routine converts an
unsigned integer to a hexadecimal ASCII text string. OTS$CVT_
L_TZ supports Fortran Zw and Zw.m output conversion formats.
Format
OTS$CVT_L_TZ 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_TZ 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_TZ creates when it converts the
integer value to a hexadecimal ASCII text string. The fixed-
length-resultant-string argument is the address of a descriptor
pointing to this 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 in the ASCII text string that OTS$CVT_
L_TZ creates when it converts the integer. The number-of-digits
argument is a signed longword containing this minimum number.
If it is omitted, the default is 1. If the actual number of
significant digits in the text string that OTS$CVT_L_TZ creates
is less than this minimum number, OTS$CVT_L_TZ inserts leading
zeros in the output string. If the minimum number of digits is
zero and the integer value to be converted is also zero, OTS$CVT_
L_TZ 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 that OTS$CVT_L_TZ converts, in bytes. The
input-value-size argument is a signed longword containing the
value size. If the size is omitted, the default is 4 (longword).
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.