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.