UnicodeToUpper and UnicodeToLower (Unicode functions): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
<span style="font-size:120%; color:black"><b>String with lowercase characters changed to</b></span>
{{Template:Unicode:UnicodeToUpper subtitle}}
 
{{Template:Unicode:UnicodeToLower subtitle}}
[[Category:Intrinsic Unicode methods|UnicodeToUpper and UnicodeToLower functions]]
[[Category:Intrinsic Unicode methods|UnicodeToUpper and UnicodeToLower functions]]
[[Category:Intrinsic methods]]
[[Category:Intrinsic methods]]
Line 23: Line 25:


These functions are available as of ''Sirius Mods'' version 7.7.
These functions are available as of ''Sirius Mods'' version 7.7.
===Syntax===
==Syntax==
  %outUni = unicode:UnicodeToUpper
{{Template:Unicode:UnicodeToUpper syntax}}
 
{{Template:Unicode:UnicodeToLower syntax}}
  %outUni = unicode:UnicodeToLower
===Syntax Terms===
====Syntax Terms====
<dl>
<dl>
<dt><i>%outUni</i>
<dt><i>%outUni</i>
Line 36: Line 37:


</dl>
</dl>
===Examples===
==Examples==


Example UnicodeToUpper and UnicodeToLower statements follow:
Example UnicodeToUpper and UnicodeToLower statements follow:

Revision as of 04:23, 19 January 2011

Template:Unicode:UnicodeToUpper subtitle

Template:Unicode:UnicodeToLower subtitle

The UnicodeToUpper and UnicodeToLower functions return the Unicode alphabetic characters in the method object string as all-uppercase or all-lowercase characters, respectively. Non-alphabetic characters are returned as is, and the input string undergoes no other change.

Character references are returned for characters that do not translate to an EBCDIC character. The default substitute for non-displayable characters in your environment, say a question mark (?), is returned for characters that translate to an EBCDIC character that is not displayable.

These methods produce a one-character for one-character translation, which will fail to correctly handle unusual characters whose uppercase versions have two-characters, for example.

These functions are available as of Sirius Mods version 7.7.

Syntax

%outUnicode = unicode:UnicodeToUpper

%outUnicode = unicode:UnicodeToLower

Syntax Terms

%outUni
A Unicode variable to receive the all-uppercase or all-lowercase Unicode characters.
unicode
The input Unicode string.

Examples

Example UnicodeToUpper and UnicodeToLower statements follow:

    . . .
   %u is unicode
   %u = '} abC5xyZ! &#x394; &#x531; &#xDF;':u
   printText {~} = '{%u:toUpper}'
   printText {~} = '{%u:toLower}'
    . . .

The results are:

    %u:UnicodeToUpper = '} ABC5XYZ! &#x0394; &#x0531; ?'
    %u:UnicodeToLower = '} abc5xyz! &#x03B4; &#x0561; ?'

The tilde (~) directive is described here.