README.md

zcifonetica

Função de normalização fonética para português brasileiro.

Código escrito como biblioteca nativa para uso em aplicações Windows, Linux, macOS ou outros. Neste código, a biblioteca é implementada para ser usada diretamente com banco de dados Firebird 1 ou superior.

Compilável com Delphi em Windows e com FreePascal e Lazarus em qualquer sistema operacional aceito pela linguagem.

Uso como UDF para Firebird

1. Compile o código
2. Adicione o arquivo gerado (ZCIFonetica.dll ou ZCIFonetica.so) ao diretório UDF do Firebird
3. Adicione as funções ao banco de dados:

DECLARE EXTERNAL FUNCTION FONETICALIKE
    CSTRING(254)
RETURNS CSTRING(254)
ENTRY_POINT 'foneticaLike' MODULE_NAME 'ZCIFonetica.dll';

DECLARE EXTERNAL FUNCTION FONETICA
    CSTRING(254)
RETURNS CSTRING(254)
ENTRY_POINT 'fonetica' MODULE_NAME 'ZCIFonetica.dll';

• Use a função Fonetica em igualdades:

SELECT NOME FROM CLIENTES
WHERE Fonetica(NOME) = Fonetica(:parametro)
ORDER BY NOME 

• Use a função FoneticaLike jundamente com o operador LIKE:

SELECT NOME FROM CLIENTES
WHERE FoneticaLike(NOME) LIKE FoneticaLike(:parametro)
ORDER BY NOME 

• Exclua a função com:

DROP EXTERNAL FUNCTION ZCIFONETICA;

Melhorias a serem implementadas

• Sugestões de Ivan Guimarães Meirelles:
  • A letra L tem som de U quando está no final do nome ou quando é seguida de consoante, com exceção da consoante H;
  • As letras R e S no final dos nomes devem ser desconsideradas, por exemplo: "VALDECI" e "VALDECIR" ou "MARCO" e "MARCOS";
  • A letra P em muitos nomes é muda, como por exemplo em "BAPTISTA" que se lê "BATISTA".
• Possível complemento de regras com base neste artigo da revista Clube Delphi número 82

Publicação na Revista Clube Delphi

Esta biblioteca foi enviada à Revista Clube Delphi em 2005 por mim, devido a um concurso.