mb_convert_kana

関数の概要

mb_convert_kanaは、PHPのマルチバイト文字列関数の一つで、日本語の文字種変換を行います。主に全角と半角の変換、カタカナの種類変換（半角カナ⇔全角カナ）など、文字の表記を統一したい場合に便利です。マルチバイト文字に対応しているため、日本語を含む文字列操作で正確に処理できます。

パラメータの説明

  • string $str：変換対象の文字列。
  • string $option：（省略可）変換のオプションを指定する文字列。複数のオプションを同時に指定できます。
  • string|null $encoding：（省略可）文字エンコーディングを指定します。省略時は内部エンコーディングが使用されます。

主な変換オプションの例：

  • "r"：全角英数字を半角に変換
  • "R"：半角英数字を全角に変換
  • "n"：全角数字を半角に変換
  • "N"：半角数字を全角に変換
  • "a"：全角英数字記号を半角に変換
  • "A"：半角英数字記号を全角に変換
  • "s"：全角スペースを半角スペースに変換
  • "S"：半角スペースを全角スペースに変換
  • "k"：全角カタカナを半角カタカナに変換
  • "K"：半角カタカナを全角カタカナに変換
  • "h"：全角ひらがなを半角カタカナに変換（使う機会は少なめ）
  • "c"：半角カタカナを全角ひらがなに変換（使う機会は少なめ）

戻り値

変換後の文字列を返します。失敗すると FALSE を返すことがありますが、通常は元の文字列に対して指定した変換を適用した結果が得られます。

使用例

全角英数字を半角に変換する

<?php
$str = "２０１９年１２月３１日";
$result = mb_convert_kana($str, "r");
echo $result; // 出力結果: 2019年12月31日
?>

数字の全角表記を半角に変換し、数値を扱いやすくしています。

半角カタカナを全角カタカナに変換する

<?php
$str = "ｶﾀｶﾅ";
$result = mb_convert_kana($str, "K");
echo $result; // 出力結果: カタカナ
?>

半角カタカナを全角カタカナに統一して表示を見やすくします。

全角スペースを半角スペースに変換し、全角英数字も半角に変換する

<?php
$str = "Ｈｅｌｌｏ　Ｗｏｒｌｄ！";
$result = mb_convert_kana($str, "as");
echo $result; // 出力結果: Hello World!
?>

全角スペースと全角英数字を半角に変換。文章のフォーマットを整えたいときに役立ちます。

関連する関数

  • mb_convert_encoding：文字エンコーディングの変換を行う関数。
  • mb_strtoupper：マルチバイト文字列の大文字変換。
  • mb_strtolower：マルチバイト文字列の小文字変換。

まとめ

mb_convert_kanaは日本語の文字列を扱う際に全角・半角やカナの種類を簡単に変換できる強力な関数です。ユーザー入力の整形やデータベース格納前の正規化に使うことで、一貫した文字表記を保てます。初心者でも直感的に使えるので、PHPで日本語を扱う際はぜひ活用してみてください。

スポンサーリンク