HELPLIB.HLB  —  RTL Routines, OTS$  OTS$CVT_L_TU
    The Convert Unsigned Integer to Decimal Text routine converts an
    unsigned integer value to its unsigned decimal representation in
    an ASCII text string.

    Format

      OTS$CVT_L_TU  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

    An unsigned integer that OTS$CVT_L_TU converts to an unsigned
    decimal representation in an ASCII text string. The varying-
    input-value argument is the address of the unsigned integer.

    On VAX systems, the integer can be an unsigned byte, word, or
    longword. (The value of the input-value-size argument determines
    whether varying-input-value is a byte, word, or longword.)

    On Alpha and I64 systems, the integer can be an unsigned byte,
    word, longword, or quadword. (The value of the input-value-size
    argument determines whether varying-input-value is a byte, word,
    longword, or quadword.)

 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_TU creates when it converts the
    integer value to unsigned decimal representation in an ASCII text
    string. The fixed-length-resultant-string argument is the address
    of a descriptor pointing to this ASCII text string.

 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_TU creates. The number-of-digits argument is a signed longword
    containing the minimum number. If the minimum number of digits is
    omitted, the default is 1.

    If the actual number of significant digits in the output string
    created is less than the minimum number, OTS$CVT_L_TU inserts
    leading zeros into the output string. If the minimum number of
    digits is zero and the integer value to be converted is also
    zero, OTS$CVT_L_TU 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 this value size. If
    the size is omitted, the default is 4 (longword).

    On VAX systems, the value size must be 1, 2, or 4.

    On Alpha and I64 systems, the value size must be 1, 2, 4, or 8.
Close Help