HELPLIB.HLB  —  RTL Routines, OTS$  OTS$CVT_L_TO
    The Convert Unsigned Integer to Octal Text routine converts an
    unsigned integer to an octal ASCII text string. OTS$CVT_L_TO
    supports Fortran Ow and Ow.m output conversion formats.

    Format

      OTS$CVT_L_TO  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_TO 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_TO creates when it converts the
    integer value to an octal ASCII text string. The fixed-length-
    resultant-string argument is the address of a descriptor pointing
    to the octal 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 that OTS$CVT_L_TO generates when it
    converts the integer value to an octal ASCII text string. The
    number-of-digits argument is a signed longword containing the
    minimum number of digits. If it is omitted, the default is 1. If
    the actual number of significant digits in the octal ASCII text
    string is less than the minimum number of digits, OTS$CVT_L_TO
    inserts leading zeros into the output string. If number-of-digits
    is 0 and varying-input-value is 0, OTS$CVT_L_TO 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 the number of bytes
    in the integer to be converted by OTS$CVT_L_TO. If it is omitted,
    the default is 4 (longword).
Close Help