Преобразовывает одну кодировку «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");
?>