Calcula a chave de Metaphone de uma string

Descrição

metaphone(string $string, int $max_phonemes = 0): 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].

Parâmetros

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.

Valor Retornado

Retorna a chave de Metaphone como uma string.

Registro de Alterações

Versão	Descrição
8.0.0	Esta função retornava `false` em caso de falha.

Exemplos

Example #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"

Example #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"

Example #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"