[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NUMTOKEN()
 Determines the number of tokens in a string
------------------------------------------------------------------------------
 Syntax

     NUMTOKEN(<cString>,[<cDelimiter>],[<nSkipWidth>])
        --> nNumber

 Arguments

     <cString>  Designates the string that is passed.

     <cDelimiter>  Designates the delimiter list used by the passer.

     <nSkipWidth>  Designates after what number of delimiter characters
     or sequences to count a token.  This is helpful for counting empty
     tokens.  The default value indicates that empty tokens are not taken
     into account.

 Returns

     The number of tokens contained in the <cString> is returned.

 Description

     Use NUMTOKEN() to determine how many words (or tokens) are contained in
     the character string.  The function uses the following list of
     delimiters as a standard:

     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-3: Recommended Delimiter Sequences
     ------------------------------------------------------------------------
     Description         <cDelimiter>
     ------------------------------------------------------------------------
     Pages               CHR(12)(Form Feed)
     Sentences           ".!?"
     File Names          ":\."
     Numerical strings   ",."
     Date strings        "/."
     Time strings        ":."
     ------------------------------------------------------------------------

     The skip value designates the number of characters after which a token
     is counted again.  This also allows empty tokens, like blanks within a
     string, to be counted.

 Examples

     .  A character string is searched using the standard delimiter
        list:

        ? NUMTOKEN("Good Morning!")      // Result: 2

     .  Your own list of delimiters can be specified for particular
        reasons.  Since the delimiter list for the following example only
        contains the characters ".!?", the result is 3.

        ? NUMTOKEN("Yes!  That's it. Maybe not?", ".!?")

     .  This example shows how to count empty tokens.  Parameters
        separated by commas are counted, but some of the parameters are
        skipped.  A token is counted after at least one delimiter (comma):

        String  :=  "one,two,,four"
        ? NUMTOKEN(String, ", ", 1)      // Result: 4


See Also: TOKEN() ATTOKEN() TOKENUPPER() TOKENLOWER()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson