mb_convert_kana

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

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


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


$str = mb_convert_kana($str, "KVa");
?>
To Top