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