Netlinx Unicode Functions; Overview; Ch_To_Wc; Wc_Compare_String - AMX NETLINX PROGRAMMING LANGUAGE Manual

NetLinx UniCode Functions

Overview

NetLinx UniCode Functions allow programmers to embed Unicode String literals in their NetLinx
programs, manipulate them using run-time functions and send them to touch panels and other user
interfaces.
NetLinx UniCode Functions
_WC

CH_TO_WC

WC_COMPARE_STRING

WC_CONCAT_STRING

NetLinx Programming Language Reference Guide
This keyword is a macro for Unicode strings. All Unicode string literals must be
contained in single quotes and in the _WC macro.
WIDECHAR wcData[] = WC('Unicode String')
This keyword converts a CHAR array to a WIDECHAR array.
WIDECHAR[] CH_TO_WC(CHAR STRING[])
Parameters:
STRING - a character string to be converted.
Result:
Result is a WIDECHAR array containing the values from the CHAR array.
WIDECHAR wcData[] = CH_TO_WC('ASCII')
This keyword compares two Unicode strings.
If either string contains a '?' character, the matching character in the other
string is not compared.
The '?' is equivalent to a wildcard. For example:
INTEGER WC_COMPARE_STRING(WIDECHAR STR1[], WIDECHAR
STR2[])
Parameters:
• STR1 - the first widechar string to be compared.
• STR2 - the first widechar string to be compared.
Result:
The returned result can only be True (1) or False (0).
• 0 = the strings don't match
• 1 = the strings are the same
See COMPARE_STRING for a code example.
This keyword concatenates two WIDECHAR arrays.
WIDECHAR[] WD_CONCAT_STRING(WIDECHAR STR1[], WIDECHAR
STR2[])
Parameters:
• STR1 - the first widechar string to be concatenated.
• STR2 - the first widechar string to be concatenated.
Result:
A widechar string which concatenates STR1 and STR2
wcMyString = WC_CONCAT_STRING(wcString1,wcString2)
NetLinx UniCode Functions
173