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()