HELPLIB.HLB  —  RTL Routines, OTS$  OTS$CVT_L_TB
    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]

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2  –  Arguments

 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).
Close Help