metaphone

metaphone(string $string, [int $max_phonemes]): string
```php

Calcula la clave metaphone de `string`.

`metaphone` es similar a la función `soundex`: crea una clave similar para palabras cuya pronunciación es cercana. Es una función más precisa que `soundex` ya que tiene en cuenta la pronunciación inglesa. La clave metaphone generada es de tamaño variable.

Metaphone fue desarrollado por Lawrence Philips \<lphilips at verity dot com\>. Este método está descrito en el libro `["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995]`.

## Parámetros

`string`  
La cadena de entrada.

`max_phonemes`  
Este parámetro restringe la clave metaphone devuelta a una longitud de `max_phonemes` *caracteres*. Sin embargo, los fonemas resultantes siempre se transcriben completamente, por lo que la longitud de la cadena resultante puede ser ligeramente más larga que `max_phonemes`. El valor por omisión es `0`, lo que significa que no se aplicará ninguna limitación.

## Valores devueltos

Devuelve la clave metaphone, en forma de `string`.

## Historial de cambios

| Versión | Descripción                                     |
|---------|-------------------------------------------------|
| 8.0.0   | Esta función devolvía `false` en caso de error. |

## Ejemplos

Ejemplo con `metaphone`

El ejemplo anterior mostrará:

    string(7) "PRKRMNK"
    string(6) "PRKRMR"

Utilización del parámetro `max_phonemes`

El ejemplo anterior mostrará:

    string(5) "PRKRM"
    string(5) "PRKRM"

Utilizando el parámetro `max_phonemes`

En este ejemplo, `metaphone` está configurado para producir una cadena de cinco caracteres, pero esto requeriría dividir el fonema final (`'x'` se supone que se transcribe como `'KS'`), por lo que la función devuelve una cadena de seis caracteres.

string(6) "ASTRKS"