PHPのmb_substr()関数で文字列の一部を抽出する方法をわかりやすく解説

PHPでは、mb_substr()関数を使うことで、指定した文字列から任意の部分（部分文字列）を取り出すことができます。これはマルチバイト文字に対応した安全なsubstr()であり、文字数に基づいて動作します。位置は文字列の先頭から数えられ、最初の文字が「0」、2番目の文字が「1」というように扱われます。日本語などのマルチバイト文字列でも文字化けせずに処理できるのが大きな特徴です。

構文

string mb_substr(str $string, int $start, int $length, str $encoding)

パラメータ

このPHP関数は、$string、$start、$length、$encoding の4つの引数を受け取ります。

$string（対象の文字列）

部分文字列を抽出する元となる文字列を指定します。

$string = mb_substr("Welcome to the online tutorials!", 5, 10, "UTF-8");

$start（開始位置）

抽出を開始する位置を指定します。0以上の値の場合、先頭の文字が「0」として扱われます。たとえば「abcefg」という文字列なら、位置0は「a」、位置1は「b」に対応します。負の値を指定した場合は、文字列の末尾から数えた位置が開始点となります。

$length（長さ）

文字列から取り出す最大文字数を指定します。以下の例では、5番目の文字から10文字分を取得することになります。

// 5番目の文字から10文字分を取得（5, 10, "UTF-8"）

$encoding（文字エンコーディング）

文字エンコーディングを指定します。省略した場合やnullの場合は、内部文字エンコーディングの値が使用されます。日本語を扱う際は「UTF-8」などを明示的に指定しておくと安心です。

戻り値

startとlengthの各パラメータに基づいて、指定された文字列から選択された部分を返します。

使用例

<?php
    // mb_substr関数は文字列の選択された部分を返します
    $string = mb_substr("Welcome to the online tutorials!", 5, 10, "UTF-8");

    // 取得した文字列を大文字に変換
    $string = mb_convert_case($string, MB_CASE_UPPER, "UTF-8");

    // 出力結果は「ME TO THE」
    echo "$string";
?>

出力結果

ME TO THE