# metaphone

(PHP 4, PHP 5, PHP 7, PHP 8)

metaphone — Calcula la clave metaphone de un string

### Descripción

metaphone(string `$str`, int `$phonemes` = 0): string

Calcula la clave metaphone de `str`.

De manera similar a soundex(), metaphone crea la misma clave para palabras que suenan parecido. Es más precisa que soundex() ya que conoce las reglas básicas de la pronunciación del inglés. Las claves generadas por metaphone son de longitud variable.

Metaphone fue desarrollado por Lawrence Philips <lphilips at verity dot com>. Se describe en ["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995].

### Parámetros

`str`

  El string de entrada.

`phonemes`

  Este parámetro restringe la clave devuelta por metaphone a lo indicado en `phonemes` en caracteres de longitud. El valor por defecto es `0` lo que significa que no hay restricción

### Valores devueltos

Devuelve la clave metaphone un string, o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo básico de metaphone()

`<?php
var_dump(metaphone('programming'));
var_dump(metaphone('programmer'));
?>`

El resultado del ejemplo sería algo similar a:

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

Ejemplo #2 Utilizando el parámetro `phonemes`

`<?php
var_dump(metaphone('programming', 5));
var_dump(metaphone('programmer', 5));
?>`

El resultado del ejemplo sería algo similar a:

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