$Upcase: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 53: Line 53:
In U.S. English, no accented characters have case translation.</p>
In U.S. English, no accented characters have case translation.</p>


<!-- Index terms
<!-- Index terms: $upcase - see toUpper (String function) -->
$upcase - see toUpper (String function) -->


[[Category:SOUL $functions]]
[[Category:SOUL $functions]]

Revision as of 00:25, 29 January 2014

The $UPCASE function translates a lowercase or mixed-case string into an uppercase-only string. The translation affects only the uppercase letters of the specified language.

Syntax

$UPCASE(string [,language])

where:

The string argument represents the characters to verify. which must be entered as follows:

  • A literal enclosed by quotation marks.
  • A %variable.
  • A field name without quotation marks. In this case, the function call must be embedded in a FOR EACH RECORD loop where the current value of the field is verified.

The optional language argument specifies the language to use. The language argument is handled as follows:

  • Omitting this argument instructs Model 204 to perform the validation for U.S. English, even if the value of the LANGUSER parameter is not US.
  • An asterisk enclosed in quotation marks ('*') instructs Model 204 to use the value of the LANGUSER parameter.
  • A literal name of a valid language enclosed in quotation marks. If the name you enter is not supported, the request is canceled with an error message. See The LANGUSER parameter in the Rocket Model 204 Parameter and Command Reference Manual for the valid values.

Examples

The following examples return uppercase strings for mixed case entries.

Function code... Returns... Language

$UPCASE('Name and address')

NAME AND ADDRESS

U.S. English

$UPCASE('Île d'Orléans','FRENCHC')

ÎLE D'ORLÉANS

French Canadian

$UPCASE('Île d'Orléans')

ILE D'ORLeANS

U.S. English

Note: In U.S. English, no accented characters have case translation.