[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
TOKENLOWER()
Converts the initial alphabetic character of a token into lower case
------------------------------------------------------------------------------
Syntax
TOKENLOWER(<cString>,[<cDelimiter>],[<nNumber>])
--> cString
Arguments
<cString> [@] Designates the string that is searched for tokens
(words).
<cDelimiter> Designates the delimiter list used by the token.
<nNumber> Designates the token in which the initial alphabetic
character is converted into a lower case, alphabetic character. The
default value designates that all tokens are converted.
Returns
The processed character string is returned.
Description
TOKENLOWER() converts the initial alphbetic character of the tokens in
the <cString> into a lower case, alphabetic character. If you specify a
value for <nNumber>, only this number of tokens is processed. If you do
not specify a value for <nNumber>, all tokens in the <cString> are
processed. The function uses the following list of delimiters by
default:
CHR 32, 0, 9, 10, 13, 26, 32, 138, 141
and the characters ,.;:!?/\<<>>()^#&%+-*
The list can be replaced by your own list of delimiters, <cDelimiter>.
Here are some examples of useful delimiters:
Table 4-6: Recommended Delimiter Sequences
------------------------------------------------------------------------
Description <cDelimiter>
------------------------------------------------------------------------
Pages CHR(12)(Form Feed)
Sentences ".!?"
File Names ":\."
Numerical strings ",."
Date strings "/."
Time strings ":."
------------------------------------------------------------------------
Note
. The return value of this function can be suppressed by
implementing CSETREF() to save space in working memory.
Examples
. Convert the initial letter of all tokens into lower case
letters:
? TOKENLOWER("good Morning") // "good morning"
. This example shows that there are no detrimental effects if
you specify a token number that does not exist:
? TOKENLOWER("good Morning",, 5) // "good morning"
. Process the first two tokens using your own delimiter:
? TOKENLOWER("/AB/AB/AB", "/", 2) // "/aB/aB/AB"
See Also:
NUMTOKEN()
TOKEN()
ATTOKEN()
TOKENUPPER()
CSETREF()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson