PHP 8.3.0 RC 6 available for testing
    Submit a Pull Request Report a Bug

    mb_convert_kana

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

    mb_convert_kana — Convert "kana" one from another ("zen-kaku", "han-kaku" and more)

    说明

    mb_convert_kana(string $string, string $mode = "KV", ?string $encoding = null): string

    Performs a "han-kaku" - "zen-kaku" conversion for string string. This function is only useful for Japanese.

    参数

    string

    The string being converted.

    mode

    The conversion option.

    Specify with a combination of following options.

    Applicable Conversion Options
    Option Meaning
    r Convert "zen-kaku" alphabets to "han-kaku"
    R Convert "han-kaku" alphabets to "zen-kaku"
    n Convert "zen-kaku" numbers to "han-kaku"
    N Convert "han-kaku" numbers to "zen-kaku"
    a Convert "zen-kaku" alphabets and numbers to "han-kaku"
    A Convert "han-kaku" alphabets and numbers to "zen-kaku" (Characters included in "a", "A" options are U+0021 - U+007E excluding U+0022, U+0027, U+005C, U+007E)
    s Convert "zen-kaku" space to "han-kaku" (U+3000 -> U+0020)
    S Convert "han-kaku" space to "zen-kaku" (U+0020 -> U+3000)
    k Convert "zen-kaku kata-kana" to "han-kaku kata-kana"
    K Convert "han-kaku kata-kana" to "zen-kaku kata-kana"
    h Convert "zen-kaku hira-gana" to "han-kaku kata-kana"
    H Convert "han-kaku kata-kana" to "zen-kaku hira-gana"
    c Convert "zen-kaku kata-kana" to "zen-kaku hira-gana"
    C Convert "zen-kaku hira-gana" to "zen-kaku kata-kana"
    V Collapse voiced sound notation and convert them into a character. Use with "K","H"

    encoding

    encoding 参数为字符编码。如果省略或是 null，则使用内部字符编码。

    返回值

    The converted string.

    错误／异常

    Throws a ValueError if the combination of different modes is invalid. For example "sS".

    更新日志

    版本 说明
    8.2.0 A ValueError is now thrown if the combination of different modes is invalid.
    8.0.0 现在 encoding 可以为 null。

    示例

    示例 #1 mb_convert_kana() example

    <?php
    /* Convert all "kana" to "zen-kaku" "kata-kana" */
    $str = mb_convert_kana($str, "KVC");

    /* Convert "han-kaku" "kata-kana" to "zen-kaku" "kata-kana"
    and "zen-kaku" alphanumeric to "han-kaku" */
    $str = mb_convert_kana($str, "KVa");
    ?>

    ＋add a note

    User Contributed Notes 4 notes

    up
    4
    dn at littlealf dot net
    20 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).
    up
    1
    d at safetypub dot org
    18 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
    jdavide222 at hotmail dot com
    10 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
    -36
    sohel62 at yahoo dot com
    15 years ago
    I did that manually when I was not getting expected result using mb_convert_kana().
    <?php
    /*
    * @author Taslim Mazumder Sohel
    * @deprecated 1.0 - 2008/02/19
    *
    */
    function han_kaku_to_jen_kaku($str){
    $replace_of = array('ｳﾞ','ｶﾞ','ｷﾞ','ｸﾞ',
    'ｹﾞ','ｺﾞ','ｻﾞ','ｼﾞ',
    'ｽﾞ','ｾﾞ','ｿﾞ','ﾀﾞ',
    'ﾁﾞ','ﾂﾞ','ﾃﾞ','ﾄﾞ',
    'ﾊﾞ','ﾋﾞ','ﾌﾞ','ﾍﾞ',
    'ﾎﾞ','ﾊﾟ','ﾋﾟ','ﾌﾟ','ﾍﾟ','ﾎﾟ');
    $replace_by = array('ヴ','ガ','ギ','グ',
    'ゲ','ゴ','ザ','ジ',
    'ズ','ゼ','ゾ','ダ',
    'ヂ','ヅ','デ','ド',
    'バ','ビ','ブ','ベ',
    'ボ','パ','ピ','プ','ペ','ポ');
    $_result = str_replace($replace_of, $replace_by, $str);

    $replace_of = array('ｱ','ｲ','ｳ','ｴ','ｵ',
    'ｶ','ｷ','ｸ','ｹ','ｺ',
    'ｻ','ｼ','ｽ','ｾ','ｿ',
    'ﾀ','ﾁ','ﾂ','ﾃ','ﾄ',
    'ﾅ','ﾆ','ﾇ','ﾈ','ﾉ',
    'ﾊ','ﾋ','ﾌ','ﾍ','ﾎ',
    'ﾏ','ﾐ','ﾑ','ﾒ','ﾓ',
    'ﾔ','ﾕ','ﾖ','ﾗ','ﾘ',
    'ﾙ','ﾚ','ﾛ','ﾜ','ｦ',
    'ﾝ','ｧ','ｨ','ｩ','ｪ',
    'ｫ','ヵ','ヶ','ｬ','ｭ',
    'ｮ','ｯ','､','｡','ｰ',
    '｢','｣','ﾞ','ﾟ');
    $replace_by = array('ア','イ','ウ','エ','オ',
    'カ','キ','ク','ケ','コ',
    'サ','シ','ス','セ','ソ',
    'タ','チ','ツ','テ','ト',
    'ナ','ニ','ヌ','ネ','ノ',
    'ハ','ヒ','フ','ヘ','ホ',
    'マ','ミ','ム','メ','モ',
    'ヤ','ユ','ヨ','ラ','リ',
    'ル','レ','ロ','ワ','ヲ',
    'ン','ァ','ィ','ゥ','ェ',
    'ォ','ヶ','ヶ','ャ','ュ',
    'ョ','ッ','、','。','ー',
    '「','」','”','');
    $_result = str_replace($replace_of, $replace_by, $_result);
    return     $_result;
    }
    ?>
    ＋add a note
    To Top