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

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 3 notes

    up
    0
    jdavide222 at hotmail dot com
    12 years ago
    to make this function work you have to add following two lines above this function.

    mb_language("Ja");
    mb_internal_encoding("utf-8");

    mb_convert_kana($_POST['something_value'], "rna");
    up
    0
    d at safetypub dot org
    20 years ago
    I didn't find Japanese sorting function.
    (mb_sort_kana or something)
    Only SJIS encoding treats hankaku kata kana,
    I can't post here copy & paste version script.
    I'm sorry...
    You will replace comments with appropriate japanese string,
    and write exception handlings between lines as you like.

    <?php
    mb_internal_encoding    ("SJIS");

    $moji = /*"aiueo...wawon -?.," <- serialized hankaku kata kana 50 on hyou goes here*/;
    $moji .= "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxwz0123456789";

    for(    $i = 0; isset($moji[$i]); $i++){
    $pittan[$moji[$i]] = $i;
    }

    function     cmp($a, $b)
    {
    if (    $a == $b) {
    return     0;
    }
    return     iter(mb_convert_kana($a, "askh") ,mb_convert_kana($b, "askh"), 0);
    }

    function     iter($a, $b, $i){
    global     $pittan;
    if(!isset(    $a[$i]) || !isset($b[$i])){
    return (isset(    $b[$i]))? -1 : 1;
    }
    if (    $pittan[$a[$i]] == $pittan[$b[$i]]){
    return     iter($a, $b, ++$i);
    }
    return ((    $pittan[$a[$i]]) < ($pittan[$b[$i]]))? -1 : 1;
    }

    echo     "<pre>";
    $arr = array(/*some japanese array here*/);
    usort($arr, "cmp");
    var_dump($arr);
    ?>
    up
    -1
    dn at littlealf dot net
    21 years ago
    It seems that mb_convert_kana() doesn't convert symbols such as ' (single quoatation). It affected my program when I insert data into database.

    So, I've found 2 ways to solve this.
    1) Use Javascript to convert those non-supported symbols before sending query string to your php page.
    2) Use php function, str_replace $str, to replace those non-supported symbols. For example, $str = str_replace("'", "?", $str);
    where the first single quot is half-width(han kaku), and the second one is full-width(zen kaku).
    ＋Добавить
    To Top