A função DIFFERENCE compara os códigos American Soundex de duas strings. A função retorna um INTEGER para indicar o número de caracteres correspondentes entre os códigos Soundex.
Um código Soundex é uma string com quatro caracteres. Um código Soundex representa como uma palavra soa em vez de como ela é escrita. Por exemplo, Smith e Smyth têm o mesmo código Soundex.
Sintaxe
DIFFERENCE(string1, string2)
Argumentos
- string1
-
Uma string
CHAR, uma stringVARCHARou uma expressão que é avaliada implicitamente como um tipoCHARouVARCHAR. - string2
-
Uma string
CHAR, uma stringVARCHARou uma expressão que é avaliada implicitamente como um tipoCHARouVARCHAR.
Tipo de retorno
- INTEGER
-
A função DIFFERENCE retorna um valor
INTEGERde 0 a 4 que conta o número de caracteres correspondentes nos códigos American Soundex das duas strings. Um código Soundex tem quatro caracteres, então a função DIFFERENCE retornará4quando todos os quatro caracteres dos valores do código American Soundex das strings forem iguais. DIFFERENCE retornará0se uma das duas strings estiver vazia. A função retornará1se nenhuma string contiver caracteres válidos. A função DIFFERENCE converte apenas caracteres ASCII em letras minúsculas ou maiúsculas em inglês, incluindo a–z e A–Z. A DIFFERENCE ignora outros caracteres.
Exemplos
Para comparar os valores do Soundex das strings % e @, use o exemplo a seguir. A função retornará 1 porque nenhuma string contém caracteres válidos.
SELECT DIFFERENCE('%', '@');
+------------+
| difference |
+------------+
| 1 |
+------------+Para comparar os valores do Soundex de Amazon e uma string vazia, use o exemplo a seguir. A função retornará 0 porque uma das duas strings está vazia.
SELECT DIFFERENCE('Amazon', '');
+------------+
| difference |
+------------+
| 0 |
+------------+Para comparar os valores do Soundex das strings Amazon e Ama, use o exemplo a seguir. A função retornará 2 porque dois caracteres dos valores do Soundex das strings são iguais.
SELECT DIFFERENCE('Amazon', 'Ama');
+------------+
| difference |
+------------+
| 2 |
+------------+Para comparar os valores do Soundex das strings Amazon e +-*/%Amazon, use o exemplo a seguir. A função retornará 4 porque todos os quatro caracteres dos valores do Soundex das strings são iguais. Observe que a função ignora os caracteres inválidos +-*/% na segunda string.
SELECT DIFFERENCE('Amazon', '+-*/%Amazon');
+------------+
| difference |
+------------+
| 4 |
+------------+Para comparar os valores do Soundex das strings AC/DC e Ay See Dee See, use o exemplo a seguir. A função retornará 4 porque todos os quatro caracteres dos valores do Soundex das strings são iguais.
SELECT DIFFERENCE('AC/DC', 'Ay See Dee See');
+------------+
| difference |
+------------+
| 4 |
+------------+