AMX NETLINX PROGRAMMING LANGUAGE User Manual

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'

AMX NETLINX PROGRAMMING LANGUAGE Specifications

General

Brand	AMX
Model	NETLINX PROGRAMMING LANGUAGE
Category	Software
Language	English