/*
 * $Id: nooccur.txt 15102 2010-07-14 12:48:39Z vszakats $
 */

/*  $DOC$
 *  $FUNCNAME$
 *     FT_NOOCCUR()
 *  $CATEGORY$
 *     String
 *  $ONELINER$
 *     Find the number of times one string occurs in another
 *  $SYNTAX$
 *     FT_NOOCCUR( <cCheckFor>, <cCheckIn> ;
 *                 [, <lIgnoreCase> ] )      -> <nOccurrences>
 *  $ARGUMENTS$
 *     <cCheckFor> is the string to search for
 * 
 *     <cCheckIn> is the string to search
 * 
 *     <lIgnoreCase> is a boolean variable to force case sensitivity
 *     (optional, defaults to .F.).
 *  $RETURNS$
 *     The number of times <cCheckFor> appears in <cCheckIn>
 *  $DESCRIPTION$
 *     This function finds the number of times a string occurs in a
 *        second string.
 *  $EXAMPLES$
 *     // Find the number of times "the" appears in cMemoString, case
 *     // insensitive
 * 
 *     nNoOfOccurrences := FT_NOOCCUR( "the", cMemoString )
 * 
 *     // Find the number of times "the" appears in cMemoString, case
 *     // sensitive
 * 
 *     nNoOfOccurrences := FT_NOOCCUR( "the", cMemoString, .T. )
 *  $END$
 */
