[<<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