Преобразовывает одну кодировку «kana» в другую («zen-kaku», «han-kaku» и другие)

Описание

mb_convert_kana(string $string, string $mode = "KV", ?string $encoding = null): string

Преобразовывает «han-kaku» — «zen-kaku» для строкового аргумента string. Эта функция может быть полезной только для японского языка.

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

string

Исходная строка (string).

mode

Настройка конвертации.

Задаётся комбинацией следующих настроек.

**Возможные настройки преобразования**
Настройка	Описание
`r`	Преобразование «zen-kaku» букв в «han-kaku»
`R`	Преобразование «han-kaku» букв в «zen-kaku»
`n`	Преобразование «zen-kaku» чисел в «han-kaku»
`N`	Преобразование «han-kaku» чисел в «zen-kaku»
`a`	Преобразование «zen-kaku» букв и чисел в «han-kaku»
`A`	Преобразование «han-kaku» букв и чисел в «zen-kaku» (Для настроек «a», «A» символы берутся из диапазона U+0021 — U+007E, исключая U+0022, U+0027, U+005C, U+007E)
`s`	Преобразование «zen-kaku» пробела в «han-kaku» (U+3000 → U+0020)
`S`	Преобразование «han-kaku» пробела в «zen-kaku» (U+0020 → U+3000)
`k`	Преобразование «zen-kaku kata-kana» в «han-kaku kata-kana»
`K`	Преобразование «han-kaku kata-kana» в «zen-kaku kata-kana»
`h`	Преобразование «zen-kaku hira-gana» в «han-kaku kata-kana»
`H`	Преобразование «han-kaku kata-kana» в «zen-kaku hira-gana»
`c`	Преобразование «zen-kaku kata-kana» в «zen-kaku hira-gana»
`C`	Преобразование «zen-kaku hira-gana» в «zen-kaku kata-kana»
`V`	Свёртывает фонемы и преобразовывает их в символ. Указывается вместе с «K», «H»

encoding

Параметр encoding — это кодировка символов. Если он опущен или равен null, для него будет установлена внутренняя кодировка символов.

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

Возвращает преобразованную строку (string).

Ошибки

Будет выброшено исключение ValueError, если комбинация заданных в параметре mode режимов недопустима. Например, «sS».

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

Версия	Описание
8.2.0	Теперь выбрасывается исключение ValueError, если комбинация установленных в параметре `mode` режимов недопустима.
8.0.0	Теперь параметр `encoding` принимает значение `null`.

Примеры

Пример #1 Пример использования функции mb_convert_kana()

<?php
/* Преобразование всех символов «kana» в «zen-kaku» «kata-kana» */

$str = mb_convert_kana($str, "KVC");

/* Преобразование «han-kaku» «kata-kana» в «zen-kaku» «kata-kana»
   и «zen-kaku» буквенно-цифровых символов в «han-kaku» */
$str = mb_convert_kana($str, "KVa");
?>