ValueWToChar
This function converts an integer array of Unicode character codes to a string, where each value in the array is a double-byte word.
Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
---|---|---|---|---|---|---|
ValueWToChar | String | Synchronous | Supported | Supported | Supported | Not supported |
Syntax
- tagArray
- The name of the integer array containing the double-byte values to be converted. If no array index is specified, then the default is 0.
Note: The tag name should be enclosed in quotes, as shown in the syntax diagram, or else the function will try to use the value of the tag.
- numQtdChars
- The number of values to be converted (minimum of 1), starting with the specifed array index.
Returned value
Returns a string comprising the converted values.
Notes
Each value in the array must be a double-byte word, and each word will be split into two bytes for conversion. As such, this function only supports Unicode character codes 0 through 255. For character codes greater than 255, or when double-byte words are not needed, use the ValueToChar function.
Examples
If Array[0] = 29779, Array[1] = 25717, and Array[2] = 28521, then the returned value is “Studio”:
ValueWToChar( "Array", 3 )
If Array[10] = 29779, Array[11] = 25717, and Array[12] = 28521, then the returned value is “Studio”:
ValueWToChar( "Array[10]", 3 )