文字列の metaphone キーを計算する

# metaphone

(PHP 4, PHP 5, PHP 7)

metaphone — 文字列の metaphone キーを計算する

### 説明

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

`str` の metaphone キーを計算します。

soundex() と同様に metaphone は、 発音が似た単語について同じキーを作成します。metaphone は、 英語の発音の基本的ルールを知っているので、 soundex() よりも正確です。 metaphone が生成するキーは可変長です。

metaphone は、Lawrence Philips <lphilips at verity dot com> により 開発されました。["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995] で解説されています。

### パラメータ

`str`

  入力文字列。

`phonemes`

  このパラメータは、返される metaphone キーの長さを最大 `phonemes` 文字までに制限します。 デフォルト値の 0 は、無制限であることを意味します。

### 返り値

metaphone キーを文字列で返します。失敗した場合に `FALSE` を返します。

### 例

例1 metaphone() の基本的な例

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

上の例の出力は、 たとえば以下のようになります。

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

例2 `phonemes` パラメータの使用例

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

上の例の出力は、 たとえば以下のようになります。

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