AMX NETLINX PROGRAMMING LANGUAGE, Manual

Page: 196 / 246

NetLinx UniCode Functions
180 NetLinx Programming Language Reference Guide
NetLinx UniCode Functions (Cont.)
WC_LOWER_STRING
This function changes all alphabetic characters in the specified string to lower
case using the case mapping defined by Unicode.org.
WIDECHAR[ ] WC_LOWER_STRING (WIDECHAR STRING[ ])
Parameters :
• STRING: The widechar string to convert to lower case.
Result :
The result is the converted widechar string.
wcLCString = WC_LOWER_STRING(wcSTRING)
WC_MAX_LENGTH_STRING
This function returns the dimensioned length of a WIDECHAR string. This
function provides the same information as MAX_LENGTH_ARRAY.
LONG WC_MAX_LENGTH_STRING (WIDECHAR STRING[ ])
Parameters :
• STRING: The input widechar string.
Result :
The result is the dimensioned length of STRING.
MaxLen = WC_MAX_LENGTH_STRING(wcSTRING)Len =
WC_LENGTH_STRING(wcSTRING)IF (MaxLen > Len){// append
character to wcSTRING}
WC_MID_STRING
This function returns the specified number of characters, starting at the speci-
fied location in the source string.
WIDECHAR[ ] WC_MID_STRING (WIDECHAR STRING[], LONG
Start, LONG Count)
Parameters :
• STRING: The input character string.
• Start: Starting location in the string.
• Count: Number of characters to extract.
Result :
The result is a widechar string containing the specified characters.
wcSTRING = _WC('ABCDEFGHIJK')wcSubstr =
WC_MID_STRING(wcSTRING, 5, 4)// wcSubstr = 'EFGH'
WC_REMOVE_STRING
This function removes characters from the specified string. All characters up to
and including the first occurrence of the specified sequence are removed.
WIDECHAR[ ] WC_REMOVE_STRING (WIDECHAR STRING[],
WIDECHAR Seq[], LONG Start)
Parameters :
• STRING: String from which to find and remove characters.
• Seq: Sequence of characters to find.
• Start: Starting position in the string to begin search.
Result :
The result is a string containing the removed characters. If the character
sequence was not found, an empty string is returned.
wcSTRING = _WC('ABCDEF')wcSubstr =
WC_REMOVE_STRING(wcSTRING, _WC('BC'), 1)// wcSubstr =
'ABC'// wcSTRING = 'DEF'