HELPLIB.HLB  —  RTL Routines, OTS$  OTS$CVT_TU_L
    The Convert Unsigned Decimal Text to Integer routine converts an
    ASCII text string representation of an unsigned decimal value to
    an unsigned integer value. By default, the size of the result is
    a longword.

    Format

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

    Input string containing an ASCII text string representation of an
    unsigned decimal value that OTS$CVT_TU_L converts to an unsigned
    integer value. The fixed-or-dynamic-input-string argument is the
    address of a descriptor pointing to the input string. Valid input
    characters are the space and the digits 0 through 9. No sign is
    permitted.

 varying-output-value

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

    Unsigned integer that OTS$CVT_TU_L creates when it converts
    the ASCII text string. The varying-output-value argument is the
    address of the unsigned 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 integer (signed)
    access:       read only
    mechanism:    by value

    Number of bytes occupied by the value created when OTS$CVT_
    TU_L converts the input string. 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_TU_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_TU_L creates is a byte, word,
    longword, or quadword.

    For VAX, Alpha, and I64 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_TU_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_TU_L uses to determine how
    blanks and tabs are interpreted. The flags-value argument
    contains the user-supplied flags as described in the following
    table:

    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_TU_L defaults all
    flags to clear.
Close Help