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

Функция преобразовывает кодировку значения с типом string, которое принимает параметр string, из "han-kaku" в "zen-kaku". Функция полезна только для японского языка.

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

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

/* Преобразование символов "han-kaku" "kata-kana" в "zen-kaku" "hira-gana" */
echo mb_convert_kana('ヤマダ ハナコ', "HV") . "\n";

/* Преобразование "han-kaku" "kata-kana" в "zen-kaku" "kata-kana"
и "zen-kaku" буквенно-цифровых символов в "han-kaku" */
echo mb_convert_kana('コウザバンゴウ 0123456', "KVa") . "\n";

?>

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

やまだ はなこ
コウザバンゴウ 0123456