The Convert Unsigned Integer to Decimal Text routine converts an unsigned integer value to its unsigned decimal representation in an ASCII text string. Format OTS$CVT_L_TU varying-input-value ,fixed-length-resultant-string [,number-of-digits] [,input-value-size]
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 An unsigned integer that OTS$CVT_L_TU converts to an unsigned decimal representation in an ASCII text string. The varying- input-value argument is the address of the unsigned integer. On VAX systems, the integer can be an unsigned 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 an unsigned 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, fixed length Output string that OTS$CVT_L_TU creates when it converts the integer value to unsigned decimal representation in an ASCII text string. The fixed-length-resultant-string argument is the address of a descriptor pointing to this ASCII text string. number-of-digits OpenVMS usage:longword_signed type: longword (signed) access: read only mechanism: by value Minimum number of digits in the ASCII text string that OTS$CVT_ L_TU creates. The number-of-digits argument is a signed longword containing the minimum number. If the minimum number of digits is omitted, the default is 1. If the actual number of significant digits in the output string created is less than the minimum number, OTS$CVT_L_TU inserts leading zeros into the output string. If the minimum number of digits is zero and the integer value to be converted is also zero, OTS$CVT_L_TU 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. On Alpha and I64 systems, the value size must be 1, 2, 4, or 8.