array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.mb-convert-kana.php', 1 => 'mb_convert_kana', 2 => 'Преобразовывает одну кодировку "kana" в другую: "zen-kaku", "han-kaku" и другие', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Функции для работы с многобайтовыми строками', ), 'prev' => array ( 0 => 'function.mb-convert-encoding.php', 1 => 'mb_convert_encoding', ), 'next' => array ( 0 => 'function.mb-convert-variables.php', 1 => 'mb_convert_variables', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mbstring/functions/mb-convert-kana.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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('ｺｳｻﾞﾊﾞﾝｺﾞｳ ０１２３４５６', "KVa") . "\n";

?>

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

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