【WordPress】全角半角混在でも指定の文字数を取り出す最も簡単な方法

ワードプレスはマルチバイトの文字コード（UTF8）を使っていることから、文字列の切り出しでは mb_substr() をよく使うと思います。

ただ日本語文字を全角1文字、英数記号を半角の0.5文字とカウントして文字列を取り出したい場合、mb_substr() では半角の英数記号でも日本語の全角文字でも1文字としてカウントするので、意図する文字数が切り出せない。

そこで全角半角を「幅」として見て、mb_strimwidth()を使うのが簡単にできて良さそうです。（文字数カウントだけなら mb_strwidth() ！）

Contents

全角半角混在でも指定の文字数を切り出す

mb_strimwidth() は、半角を1文字、全角を2文字として扱い、
文字列から指定の文字数を丸めて取り出します。

仕様的には以下のようになってます。

※）④、⑤は省略でもOK

「丸めて」というのは、文字の途中までしか指定されない場合には（たとえば「あ」の半分までのデータが指定されたりすると文字として分からなくなることから）、その文字は取らず直前までを取得する（丸める）ということのようですね。

例えば簡単な文字列として「12あい」と前半が半角数字2文字、
後半が日本語の平仮名2文字（全角2文字：つまり半角4文字分）の計半角6文字分の文字列があるとします。

$str = "12あい" とし、
この $str に対して、先頭（0）から1文字分、2文字分、3文字分など第三引数で指定して文字列を取り出してみると．．．

１）では、先頭から（半角）1文字分なので「1」だけ。
２）では、先頭から（半角）2文字分なので「12」。
３）では、先頭から（半角）3文字分のところ、3文字目はあいにく全角文字（半角2文字分）の「あ」なので、その文字は取り切れず「12」のみが取り出される。（丸められた）

４）では先頭から（半角）4文字分を取り出すので「あ」まで取り切れて、
結果「12あ」が取得できた。

元の文字列 $str より多い切り取り文字数が指定される７），８）では、
文字列全体（12あい）のみが取り出されるってことになります。

半角を1文字、全角を2文字として数えるので、
日本語（全角）10文字分取り出したい場合には、2をかけて20を第三引数に指定すればよいことになりますね。

ワードプレスのブログによくある記事一覧では記事の抜粋表示がありますが、半角全角混在でも見た目の文字数の量を割ときっちりそろえたい場合に使えそう。

切り出した文字列の最後にマーク（文字列）を付加できるようになってますが（第4引数）、この付加するマークの文字列も切り出し文字数にカウントされるのが注意ポイント。

たとえば、$str = "12345あいうえお" （半角で15文字分の文字列）
最後に付加するマークを ' [...]' （半角スペース＋半角5文字」の（半角）6文字分）として第四引数に指定してみると．．．