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 и описана в книге["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995]
Список параметрів
string
Вхідний рядок.
max_phonemes
Цей параметр виставляє обмеження в max_phonemes символів на довжину ключа, що повертається metaphone. Однак результуючі фонеми завжди транскрибуються повністю, тому довжина результуючого рядка може бути трохи більшою, ніж phonemesЗначение по умолчанию означает отсутствие ограничений.
Значення, що повертаються
Повертає ключ metaphone у вигляді рядка.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Функція повертала **false**в случае возникновения ошибки. |
Приклади
Приклад #1 Простий приклад використання metaphone()
Результат виконання наведеного прикладу:
string(7) "PRKRMNK"
string(6) "PRKRMR"
Приклад #2 Использование параметраmax_phonemes
Результат виконання наведеного прикладу:
string(5) "PRKRM"
string(5) "PRKRM"
Приклад #3 Использование параметраmax_phonemes
У цьому прикладі metaphone() пропонується створити рядок з п'яти символів, але для цього потрібно розділити останню фонему ('x' передбачається перетворити на 'KS'), тому функція повертає рядок із шести символів.
Результат виконання наведеного прикладу:
string(6) "ASTRKS"