VMS Help  —  RTL Routines, OTS$  OTS$CVT_L_TZ
    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]

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