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

/*  $DOC$
 *  $FUNCNAME$
 *     FT_METAPH()
 *  $CATEGORY$
 *     String
 *  $ONELINER$
 *     Convert a character string to MetaPhone format
 *  $SYNTAX$
 *     FT_METAPH( <cName> [, <nSize> ] ) -> cMetaPhone
 *  $ARGUMENTS$
 *     <cName> is the character string to convert
 * 
 *     <nSize> is the length of the character string to be returned.
 *             If not specified the default length is 4 bytes.
 *  $RETURNS$
 *     A phonetically spelled character string
 *  $DESCRIPTION$
 *     This function is a character function use to index and search for
 *     sound-alike or phonetic matches.  It is an alternative to
 *     the SOUNDEX() function, and addresses some basic pronunciation
 *     rules, by looking at surrounding letters to determine how parts of
 *     the string are pronounced.  FT_METAPH() will group sound-alikes
 *     together, and forgive shortcomings in spelling ability.
 *  $EXAMPLES$
 *     USE Persons
 *     INDEX ON FT_METAPH( LastName ) TO LastName
 *     SEEK FT_METAPH( "Philmore" )
 *     ? FOUND(), LastName             // Result: .T. Philmore
 *     SEEK FT_METAPH( "Fillmore" )
 *     ? FOUND(), LastName             // Result: .T. Philmore
 *  $END$
 */
