The Convert Integer to Hexadecimal Text routine converts an unsigned integer to a hexadecimal ASCII text string. OTS$CVT_ L_TZ supports Fortran Zw and Zw.m output conversion formats. Format OTS$CVT_L_TZ 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 Unsigned byte, word, or longword that OTS$CVT_L_TZ converts to an unsigned decimal representation in an ASCII text string. (The value of the input-value-size argument determines whether varying-input-value is a byte, word, or longword.) The varying- input-value argument is the address of the unsigned integer. 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_TZ creates when it converts the integer value to a hexadecimal ASCII text string. The fixed- length-resultant-string argument is the address of a descriptor pointing to this ASCII text string. The string is assumed to be of fixed length (CLASS_S descriptor). 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_TZ creates when it converts the integer. The number-of-digits argument is a signed longword containing this minimum number. If it is omitted, the default is 1. If the actual number of significant digits in the text string that OTS$CVT_L_TZ creates is less than this minimum number, OTS$CVT_L_TZ inserts leading zeros in the output string. If the minimum number of digits is zero and the integer value to be converted is also zero, OTS$CVT_ L_TZ 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 that OTS$CVT_L_TZ converts, in bytes. The input-value-size argument is a signed longword containing the value size. If the size is omitted, the default is 4 (longword).