HELPLIB.HLB  —  RTL Routines, OTS$  OTS$CVT_L_TI
    The Convert Signed Integer to Decimal Text routine converts a
    signed integer to its decimal representation in an ASCII text
    string. This routine supports Fortran Iw and Iw.m output and
    BASIC output conversion.

    Format

      OTS$CVT_L_TI  varying-input-value

                    ,fixed-length-resultant-string

                    [,number-of-digits] [,input-value-size]

                    [,flags-value]

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, fixed length

    A signed integer that OTS$CVT_L_TI converts to a signed decimal
    representation in an ASCII text string. The varying-input-value
    argument is the address of the signed integer.

    On VAX systems, the integer can be a signed 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 a signed 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

    Decimal ASCII text string that OTS$CVT_L_TI creates when it
    converts the signed integer. The fixed-length-resultant-string
    argument is the address of a CLASS_S descriptor pointing to this
    text string. The string is assumed to be of fixed length.

 number-of-digits

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by value

    Minimum number of digits to be generated when OTS$CVT_L_TI
    converts the signed integer to a decimal ASCII text string.
    The number-of-digits argument is a signed longword containing
    this number. If the minimum number of digits is omitted, the
    default value is 1. If the actual number of significant digits
    is smaller, OTS$CVT_L_TI inserts leading zeros into the output
    string. If number-of-digits is zero and varying-input-value is
    zero, OTS$CVT_L_TI 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. If value
    size is 1 or 2, the value is sign-extended to a longword before
    conversion.

    On Alpha and I64 systems, the value size must be 1, 2, 4, or
    8. If the value is 1, 2, or 4, the value is sign-extended to a
    quadword before conversion.

 flags-value

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value

    Caller-supplied flags that you can use if you want OTS$CVT_L_TI
    to insert a plus sign before the converted number. The flags-
    value argument is an unsigned longword containing the flags.

    The caller flags are described in the following table:

    Bit  Action if Set         Action if Clear

    0    Insert a plus sign    Omit the plus sign.
         (+)  before the
         first nonblank
         character in the
         output string.

    If flags-value is omitted, all bits are clear and the plus sign
    is not inserted.
Close Help