VMS Help  —  RTL Routines, OTS$  OTS$CVT_TI_L
    The Convert Signed Integer Text to Integer routine converts an
    ASCII text string representation of a signed decimal number
    to a signed integer value. The default size of the result is a
    longword.

    Format

      OTS$CVT_TI_L  fixed-or-dynamic-input-string

                    ,varying-output-value [,output-value-size]

                    [,flags-value]

1  –  Returns

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

2  –  Arguments

 fixed-or-dynamic-input-string

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor, fixed-length or dynamic string

    Input ASCII text string that OTS$CVT_TI_L converts to a signed
    integer. The fixed-or-dynamic-input-string argument is the
    address of a descriptor pointing to the input string.

    [+ or -]<integer-digits>

    OTS$CVT_TI_L always ignores leading blanks.

 varying-output-value

    OpenVMS usage:varying_arg
    type:         unspecified
    access:       write only
    mechanism:    by reference

    Signed integer that OTS$CVT_TI_L creates when it converts the
    ASCII text string. The varying-output-value argument is the
    address of the signed integer. The value of the output-value-size
    argument determines the size of varying-output-value.

 output-value-size

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

    Number of bytes to be occupied by the value created when OTS$CVT_
    TI_L converts the ASCII text string to an integer value. The
    output-value-size argument contains the number of bytes in
    varying-output-value.

    On VAX systems, valid values for the output-value-size argument
    are 1, 2, and 4. The value determines whether the integer value
    that OTS$CVT_TI_L creates is a byte, word, or longword.

    On Alpha and I64 systems, valid values for the output-value-
    size argument are 1, 2, 4, and 8. The value determines whether
    the integer value that OTS$CVT_TI_L creates is a byte, word,
    longword, or quadword.

    For VAX and Alpha systems, if you specify a 0 (zero) or omit the
    output-value-size argument, the size of the output value defaults
    to 4 (longword). If you specify any other value, OTS$CVT_TI_L
    returns an input conversion error.

 flags-value

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

    User-supplied flags that OTS$CVT_TI_L uses to determine how
    blanks and tabs are interpreted. The flags-value argument is
    an unsigned longword containing the value of the flags.

    Bit  Action if Set    Action if Clear

    0    Ignore all       Ignore leading blanks but interpret blanks
         blanks.          after the first legal character as zeros.
    4    Ignore tabs.     Interpret tabs as invalid characters.

    If you omit the flags-value argument, OTS$CVT_TI_L defaults all
    flags to clear.
Close Help