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 |
| ValueWToChar
|
String |
Synchronous |
Supported |
Supported |
Supported |
Syntax
ValueWToChar("tagArray",numQtdChars)
- 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 must be enclosed in quotes, as shown in the syntax diagram, or
else the project will try to get the value of the named
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 )