$Lowcase: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Mlarocca moved page $LOWCASE to $Lowcase: Lower case change)
m (character translation)
 
Line 1: Line 1:
<p>The $LOWCASE function translates an uppercase or mixed-case string into a lowercase string. The translation affects only characters with uppercase and lowercase pairs, for example, A to a through Z to z in U.S. English. These are not strictly keyboard pairs. If the first character in the string is alphabetic, the character is converted to uppercase.</p>
<p>
<b>Syntax</b>
The <var>$Lowcase</var> function translates an uppercase or mixed-case string into a lowercase string. The translation affects only characters with uppercase and lowercase pairs, for example, A to a through Z to z in U.S. English. These are not strictly keyboard pairs. If the first character in the string is alphabetic, the character is converted to uppercase.</p>
<p class="code">$LOWCASE(<var class="term">string</var>[,<var class="term">language</var>])
 
==Syntax==
<p class="syntax">$Lowcase(<span class="term">string</span>[,<span class="term">language</span>])
</p>
</p>
<p>where:</p>
<p>where:</p>
<p><var>The string</var> argument represents the characters to verify, which must be entered as follows:</p>
<p>
The <var class="term">string</var> argument represents the characters to verify, which must be entered as follows:</p>
<ul>
<ul>
<li>A literal enclosed in quotation marks.</li>
<li>A literal enclosed in quotation marks.</li>
</li>
 
<li>A %variable.</li>
<li>A %variable.</li>
</li>
 
<li>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.</li>
<li>A field name without quotation marks. In this case, the function call must be embedded in a <var>FOR EACH RECORD</var> loop where the current value of the field is verified.</li>
</li>
</ul>
</ul>
<p><var>The optional language</var> argument specifies the language to use, which is handled as follows:</p>
<p>
<var>The optional language</var> argument specifies the language to use, which is handled as follows:</p>
<ul>
<ul>
<li>Omitting the language argument instructs <var class="product">Model&nbsp;204</var> to perform the validation in U.S. English, even if the value of the LANGUSER parameter is not US.</li>
<li>Omitting the language argument instructs <var class="product">Model&nbsp;204</var> to perform the validation in U.S. English, even if the value of the <var>LANGUSER</var> parameter is not US.</li>
</li>
 
<li>An asterisk enclosed by quotation marks ('*') instructs <var class="product">Model&nbsp;204</var> to use the value of the LANGUSER parameter.</li>
<li>An asterisk enclosed by quotation marks (<tt>'*'</tt>) instructs <var class="product">Model&nbsp;204</var> to use the value of the <var>LANGUSER</var> parameter.</li>
</li>
 
<li>You can enter 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 <var class="product">Model&nbsp;204</var> Parameter and Command Reference Manual for the valid values.</li>
<li>You can enter 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 <var>[[LANGUSER parameter]]</var> for the valid values.</li>
</li>
</ul>
</ul>
<b>Example</b>
 
<p>The following example returns the string 'Name and address' in U.S. English:</p>
==Example==
<p>
The following example returns the string 'Name and address' in U.S. English:</p>
<p class="code">$LOWCASE('NAME AND ADDRESS')
<p class="code">$LOWCASE('NAME AND ADDRESS')
</p>
</p>
<p>The following example returns the string '�� et l�' in French Canadian:</p>
<p>
<p class="code">$LOWCASE('�� ET L�','FRENCHC')
The following example returns the string '&Ccedil;&agrave; et l&agrave;' in French Canadian:</p>
<p class="code">$LOWCASE('&Ccedil;&Agrave; ET L&Agrave;','FRENCHC')
</p>
</p>
[[Category:SOUL $functions]]
[[Category:SOUL $functions]]

Latest revision as of 18:41, 9 March 2015

The $Lowcase function translates an uppercase or mixed-case string into a lowercase string. The translation affects only characters with uppercase and lowercase pairs, for example, A to a through Z to z in U.S. English. These are not strictly keyboard pairs. If the first character in the string is alphabetic, the character is converted to uppercase.

Syntax

$Lowcase(string[,language])

where:

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

  • A literal enclosed in 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, which is handled as follows:

  • Omitting the language argument instructs Model 204 to perform the validation in U.S. English, even if the value of the LANGUSER parameter is not US.
  • An asterisk enclosed by quotation marks ('*') instructs Model 204 to use the value of the LANGUSER parameter.
  • You can enter 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 LANGUSER parameter for the valid values.

Example

The following example returns the string 'Name and address' in U.S. English:

$LOWCASE('NAME AND ADDRESS')

The following example returns the string 'Çà et là' in French Canadian:

$LOWCASE('ÇÀ ET LÀ','FRENCHC')