Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Tools : LOWERCASE

LOWERCASE
Converts all uppercase characters in a string to lowercase characters. (F)
Invocation
lower_string = LOWERCASE(string)
 
On return, contains the string in lowercase letters. Its syntax is V (variable-length character string) except that, if string is UN (Unicode), lower_string becomes UN.
The string to convert to lowercase letters. Its syntax can be C (fixed-length character string), UN, V, or W (double-byte character).
Usage Note
LOWERCASE lowercases EBCDIC strings using the TIBCO Object Service Broker EBCDIC casing rules and Unicode strings using the TIBCO Object Service Broker Unicode casing rules.
Example
This rule lowercases a string and prints the result to the message log:

 
LOWERCASE_SAMPLE;
_ LOCAL A;
_ ---------------------------------------------------------------------------
_ ------------------------------------------------------------+--------------
_ A = U'AÇaç'; ¦ 1
_ CALL MSGLOG('CASING OF UNICODE STRING ' || A); ¦ 2
_ CALL MSGLOG(' '); ¦ 3
_ CALL MSGLOG('LOWERCASE GIVES ' || LOWERCASE(A)); ¦ 4
_ CALL MSGLOG('SYNTAX IS ' || $GET_SYNTAX(LOWERCASE(A)); ¦ 5
_ A = $TYPECAST('S', 'V', 4, 0, A); ¦ 6
_ CALL MSGLOG(' '); ¦ 7
_ CALL MSGLOG('CASING OF EBCDIC STRING ' || A); ¦ 8
_ CALL MSGLOG(' '); ¦ 9
_ CALL MSGLOG('LOWERCASE GIVES ' || LOWERCASE(A)); ¦ A
_ CALL MSGLOG('SYNTAX IS ' || $GET_SYNTAX(LOWERCASE(A)); ¦ B

 
Line 1 sets local variable A as a Unicode string. Line 6 changes it to an EBCDIC V string.
Displayed Output for the LOWERCASE_1 Rule
Pressing PF2 after executing this rule displays the following:

 
COMMAND ===> SCROLL ===> P
CASING OF UNICODE STRING AÇaç
LOWERCASE GIVES açaç
SYNTAX IS UN
CASING OF EBCDIC STRING AÇaç
LOWERCASE GIVES aÇaç
SYNTAX IS V

 
See Also
Related tools: LOWER_EBCDIC, LOWER_UNICODE, UPPER_EBCDIC, UPPER_UNICODE, and UPPERCASE.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved