Wc_Lower_String; Wc_Max_Length_String; Wc_Mid_String; Wc_Remove_String - AMX NETLINX PROGRAMMING LANGUAGE Manual

NetLinx UniCode Functions
NetLinx UniCode Functions (Cont.)

WC_LOWER_STRING

WC_MAX_LENGTH_STRING This function returns the dimensioned length of a WIDECHAR string. This

WC_MID_STRING

WC_REMOVE_STRING

180
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)
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}
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'
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'
NetLinx Programming Language Reference Guide