$Lowcase: Difference between revisions
m (character translation) |
|||
Line 1: | Line 1: | ||
<p>The $ | <p> | ||
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=" | |||
==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> | <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>A %variable.</li> | <li>A %variable.</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>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 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 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>An asterisk enclosed by quotation marks ('*') instructs <var class="product">Model 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 204</var> to use the value of the <var>LANGUSER</var> parameter.</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 | <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> | ||
<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 ' | <p> | ||
<p class="code">$LOWCASE(' | The following example returns the string 'Çà et là' in French Canadian:</p> | ||
<p class="code">$LOWCASE('ÇÀ ET LÀ','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')