array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.mb-convert-kana.php', 1 => 'mb_convert_kana', ), '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' => 'ja', 'path' => 'reference/mbstring/functions/mb-convert-kana.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_convert_kana — カナを("全角かな"、"半角かな"等に)変換する
文字列
string
に関して「半角」-「全角」変換を行います。
この関数は、日本語のみで使用可能です。
string
変換される文字列。
mode
変換オプション。
以下のオプションを組み合わせて指定します。
オプション | 意味 |
---|---|
r |
「全角」英字を「半角」に変換します。 |
R |
「半角」英字を「全角」に変換します。 |
n |
「全角」数字を「半角」に変換します。 |
N |
「半角」数字を「全角」に変換します。 |
a |
「全角」英数字を「半角」に変換します。 |
A |
「半角」英数字を「全角」に変換します ("a", "A" オプションに含まれる文字は、U+0022, U+0027, U+005C, U+007Eを除く U+0021 - U+007E の範囲です)。 |
s |
「全角」スペースを「半角」に変換します(U+3000 -> U+0020)。 |
S |
「半角」スペースを「全角」に変換します(U+0020 -> U+3000)。 |
k |
「全角カタカナ」を「半角カタカナ」に変換します。 |
K |
「半角カタカナ」を「全角カタカナ」に変換します。 |
h |
「全角ひらがな」を「半角カタカナ」に変換します。 |
H |
「半角カタカナ」を「全角ひらがな」に変換します。 |
c |
「全角カタカナ」を「全角ひらがな」に変換します。 |
C |
「全角ひらがな」を「全角カタカナ」に変換します。 |
V |
濁点付きの文字を一文字に変換します。"K", "H" と共に使用します。 |
encoding
encoding
パラメータには文字エンコーディングを指定します。省略した場合、もしくは null
の場合は、
内部文字エンコーディングを使用します。
変換後の文字列を返します。
異なる mode
の組み合わせが無効な場合 (例: "sS"
) は、
ValueError がスローされます。
バージョン | 説明 |
---|---|
8.2.0 |
異なる mode の組み合わせが無効な場合、
ValueError がスローされるようになりました。
|
8.0.0 |
encoding は、nullable になりました。
|
例1 mb_convert_kana() の例
<?php
/* 「仮名」を全て「全角カタカナ」に変換します */
$str = mb_convert_kana($str, "KVC");
/* 「半角カタカナ」を「全角カタカナ」に変換し、「全角」英数字を「半角」
に変換します。 */
$str = mb_convert_kana($str, "KVa");
?>