VMS Help
RTL Routines, OTS$, OTS$CVT_L_TB
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
The Convert an Unsigned Integer to Binary Text routine converts
an unsigned integer value of arbitrary length to binary
representation in an ASCII text string. By default, a longword
is converted.
Format
OTS$CVT_L_TB 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_TB 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
ASCII text string that OTS$CVT_L_TB creates when it converts the
integer value. 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 binary representation to be
generated. The number-of-digits argument is a signed longword
containing this minimum number. If the minimum number of digits
is omitted, the default is 1. If the actual number of significant
digits is less than the minimum number of digits, leading zeros
are produced. If the minimum number of digits is zero and the
value of the integer to be converted is also zero, OTS$CVT_L_TB
creates a blank 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 byte size. This
is an optional argument. 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.