Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

SOUNDEX

SOUNDEX

Codifica um valor de string em uma string de quatro caracteres.
SOUNDEX funciona em caracteres no alfabeto em inglês (A-Z). Ele usa o primeiro caractere da string de entrada como o primeiro caractere no valor retornado e codifica as três consoantes exclusivas remanescentes como números.
SOUNDEX codifica caracteres de acordo com a seguinte lista de regras:
  • Usa o primeiro caractere na
    string
    como o primeiro caractere no valor retornado e o codifica em letra maiúscula. Por exemplo, SOUNDEX(‘John’) e SOUNDEX(‘john’) retornam ‘J500’.
  • Codifica as três primeiras consoantes exclusivas após o primeiro caractere na
    string
    e ignora o restante. Por exemplo, SOUNDEX(‘JohnRB’) e SOUNDEX(‘JohnRBCD’) retornam ‘J561’.
  • Atribui um código único a consoantes que soam de forma semelhante.
    A seguinte tabela lista diretrizes de codificação SOUNDEX para consoantes:
    Diretrizes de Codificação SOUNDEX para consoantes
    Código
    Consoante
    1
    B, P, F, V
    2
    C, S, G, J, K, Q, X, Z
    3
    D, T
    4
    L
    5
    M, N
    6
    R
  • Ignora os caracteres A, E, I, O, U, H e W, a menos que um deles seja o primeiro caracteres na
    string
    . Por exemplo, SOUNDEX(‘A123’) retorna ‘A000’ e SOUNDEX(‘MAeiouhwC’) retorna ‘M200’.
  • Se
    string
    produz menos de quatro caracteres, SOUNDEX preenche a string resultante com zeros. Por exemplo, SOUNDEX(‘J’) retorna ‘J000’.
  • Se a
    string
    contiver um conjunto de consoantes consecutivas que usam o mesmo código listado em SOUNDEX, SOUNDEX codificará a primeira ocorrência e ignorará as ocorrências remanescentes no conjunto. Por exemplo, SOUNDEX(‘AbbpdMN’) retorna ‘A135’.
  • Ignora números na
    string
    . Por exemplo, SOUNDEX(‘Joh12n’) e SOUNDEX(‘1John’) retornam ‘J500’.
  • Retornará NULL se
    string
    for NULL ou se todos os caracteres na
    string
    não forem letras do alfabeto em inglês.

Sintaxe

SOUNDEX(
string
)
A tabela a seguir descreve o argumento para este comando:
Argumento
Obrigatório/
Opcional
Descrição
string
Obrigatório
String de caracteres. Passa o valor de string que você deseja codificar. Você pode inserir qualquer expressão válida de transformação.

Valor de Retorno

Cadeia.
NULL se uma das seguintes condições for verdadeira:
  • Se o valor passado para a função for NULL.
  • Nenhum caractere na
    string
    é uma letra do alfabeto inglês.
  • string
    está vazia.

Exemplo

A seguinte expressão codifica os valores na porta EMPLOYEE_NAME:
SOUNDEX( EMPLOYEE_NAME )
EMPLOYEE_NAME
RETURN VALUE
John
J500
William
W450
jane
J500
joh12n
J500
1abc
A120
NULL
NULL