array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.metaphone.php', 1 => 'metaphone', 2 => 'Возвращает ключ metaphone для строки', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Функции для работы со строками', ), 'prev' => array ( 0 => 'function.md5-file.php', 1 => 'md5_file', ), 'next' => array ( 0 => 'function.money-format.php', 1 => 'money_format', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/strings/functions/metaphone.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

metaphone

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

metaphone — Возвращает ключ metaphone для строки

Описание

metaphone(string $string, int $max_phonemes = 0): string

Возвращает ключ metaphone для строки string.

Подобно функции soundex(), metaphone возвращает одинаковое значение для слов, имеющих сходное произношение. Эта функция более точна, чем soundex(), так как учитывает основные правила произношения английского языка. Длина возвращаемой строки не фиксирована.

Функция metaphone была написана Lawrence Philips <lphilips at verity dot com> и описана в книге ["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995].

Список параметров

string

Входная строка.

max_phonemes

Этот параметр выставляет ограничение в max_phonemes символов на длину возвращаемого ключа metaphone. Однако результирующие фонемы всегда транскрибируются полностью, поэтому длина результирующей строки может быть немного больше, чем phonemes. Значение по умолчанию 0 означает отсутствие ограничений.

Возвращаемые значения

Возвращает ключ metaphone в виде строки.

Список изменений

Версия Описание
8.0.0 Функция возвращала false в случае возникновения ошибки.

Примеры

Пример #1 Простой пример использования metaphone()

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

Результат выполнения приведённого примера: 

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

Пример #2 Использование параметра max_phonemes

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

Результат выполнения приведённого примера: 

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

Пример #3 Использование параметра max_phonemes

В этом примере metaphone() предлагается создать строку из пяти символов, но для этого потребуется разделить последнюю фонему ('x' предполагается преобразовать в 'KS'), поэтому функция возвращает строку из шести символов.

<?php
var_dump(metaphone('Asterix', 5));
?>

Результат выполнения приведённого примера: 

string(6) "ASTRKS"

Смотрите также