SOUNDEX()
 Converte uma cadeia de caracteres para formato soundex
------------------------------------------------------------------------------

 Sintaxe

     SOUNDEX(<cString>) --> cStringSoundex

 Argumentos

     <cString> é a cadeia de caracteres a ser convertida.

 Retorno

     SOUNDEX() retorna uma cadeia de caracteres de quatro dígitos no formato
     A999.

 Descriçao

     SOUNDEX() é uma funçao de tratamento de caracteres utilizada para
     indexar e pesquisar correspondências fonéticas e sonoras.  É utilizada
     em aplicaçoes onde nao se conhece a ortografia correta de chaves do
     tipo caractere, ou quando há grande probabilidade da ocorrência de
     erros de ortografia.  Erros de ortografia sao comuns em sistemas de
     transaçao em tempo real, onde o digitador está recebendo as informaçoes
     via telefone.  SOUNDEX() funciona agrupando fonemas com o mesmo valor
     chave, porém, que o método soundex nao é perfeito.  Palavras que sao
     muito diferentes podem resultar no mesmo valor soundex.

 Exemplos

       Este exemplo constrói um índice usando SOUNDEX() para criar
        os valores chave.  Depois ele pesquisa um valor encontrado no campo
        Salesman:

        USE Sales
        INDEX ON SOUNDEX(Salesman) TO Salesman
        SEEK SOUNDEX("Smith")
        ? FOUND(), Salesman                    // Resulta: .T. Smith

       Aqui é feita uma pesquisa para a mesma chave que no exemplo
        anterior, mas com uma ortografia diferente:

        SEEK SOUNDEX("Smythe")
        ? FOUND(), Salesman                    // Resulta: .T. Smith

 Arquivos:  Biblioteca EXTEND.LIB, fonte EXAMPLEC.C.
 To download this example - click here.

See Also: INDEX LOCATE SEEK SET SOFTSEEK