(PHP 4, PHP 5, PHP 7, PHP 8)
metaphone — Calcula a chave de Metaphone de uma string
Calcula a chave de Metaphone da string
.
Parecida com a função soundex(), metaphone cria a mesma chave para palavras que soam de forma similar. É mais precisa que soundex() já que ela conhece as regras básicas de pronúncia em inglês. As chaves geradas têm comprimento variável.
Metaphone foi desenvolvido por Lawrence Philips <lphilips at verity dot com>. É descrita em ["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995].
string
A string de entrada.
max_phonemes
Este parâmetro restringe o comprimento da chave retornada ao número máximo de
characters especificado em max_phonemes
.
Entretanto, os fonemas resultantes são sempre transcritos completamente, portanto o
comprimento resultante da string pode ser um pouco maior que max_phonemes
.
O valor padrão de 0
significa sem restrição.
Retorna a chave de Metaphone como uma string.
Versão | Descrição |
---|---|
8.0.0 |
Esta função retornava false em caso de falha.
|
Exemplo #1 Exemplo básico de metaphone()
<?php
var_dump(metaphone('programming'));
var_dump(metaphone('programmer'));
?>
O exemplo acima produzirá:
string(7) "PRKRMNK" string(6) "PRKRMR"
Exemplo #2 Usando o parâmetro max_phonemes
<?php
var_dump(metaphone('programming', 5));
var_dump(metaphone('programmer', 5));
?>
O exemplo acima produzirá:
string(5) "PRKRM" string(5) "PRKRM"
Exemplo #3 Usando o parâmetro max_phonemes
Neste exemplo, metaphone() é instruída a produzir uma string
de cinco caracteres, mas isso iria separar o fonema final
('x'
deve ser transcrito para 'KS'
),
portanto a função retorna uma string com seis caracteres.
<?php
var_dump(metaphone('Asterix', 5));
?>
O exemplo acima produzirá:
string(6) "ASTRKS"