ValueToChar

ValueToChar converts an array of numeric values into Unicode characters and then returns those characters as a string.

Syntax

ValueToChar("tagArray",numQtdChars)

tagArray

The name of the array that contains the values to be converted, as well as the index of the starting position in the array. If the starting position index is not specified, the default is 0. Each value in the array should be an unsigned integer in the range from 0 through 65535.

Note: If this parameter is enclosed in quotes, the string literal will be used. Otherwise, the value of the tag/expression will be used.

numQtdChars

The number of values to be converted (minimum of 1), starting from the specified starting position.

Return value

This function returns a string containing the converted values.

Notes

Unicode character codes in the ranges from 0 (U+0000) through 31 (U+001F) and from 128 (U+0080) through 159 (U+009F) are control characters, not alphanumeric characters. In particular, 0 is a NUL character that will effectively end the string that is returned by this function.

Examples

If MyArray[0] = 65, MyArray[1] = 66, and MyArray[2] = 67, then the returned value will be "ABC":

ValueToChar("MyArray",3)

If MyArray[10] = 65, MyArray[11] = 66, and MyArray[12] = 67, then the returned value will be "ABC":

ValueToChar("MyArray[10]",3)