PHPのmb_stripos()関数とは？使い方とパラメータをわかりやすく解説

PHPのmb_stripos()関数は、ある文字列（干し草の山）の中から、指定した文字列（針）が最初に出現する位置を検索するためのマルチバイト対応関数です。この関数の最大の特徴は「大文字・小文字を区別しない」という点です。検索対象の文字列が見つかった場合、その位置を数値で返し、見つからなかった場合はFalseを返します。

マルチバイト文字列関数のため、日本語などのマルチバイト文字を含む文字列でも正しく動作する点が、通常のstripos()関数との大きな違いです。

構文

integer mb_stripos($str_haystack, $str_needle, $int_offset = 0, $str_encoding = null)

パラメータ

mb_stripos()関数は、以下の4つの引数を受け取ります。

• $str_haystack（検索対象の文字列） − 検索元となる文字列です。この中からneedle（検索したい文字列）の最初の出現位置を取得します。

• $str_needle（検索する文字列） − haystackの中から探したい文字列を指定します。

• $int_offset（検索開始位置） − 検索を開始する位置を指定します。省略した場合は0（先頭）から検索されます。負の値を指定すると、文字列の末尾から数えた位置から検索を開始します。

• $str_encoding（文字エンコーディング） − 使用する文字エンコーディング名を指定します。省略した場合は、内部文字エンコーディングが使用されます。

戻り値

指定したhaystack文字列の中で、needleが最初に出現する位置を数値（integer）で返します。needleが見つからなかった場合はFalseを返します。

使用例1

以下の例では、「PHP Tutorials」という文字列の中から「ia」を検索しています。

<?php
   mb_internal_encoding("UTF-8");

   // 文字列 "PHP Tutorials" を検索対象にする
   // offset = 0（先頭から検索）
   $string = mb_stripos("PHP Tutorials", "ia", 0);

   // 出力結果は int(9)
   var_dump($string);
?>

出力結果

int(9)

この例では、「PHP Tutorials」内の9番目の位置（0から数えて）に「ia」が見つかったため、int(9)が出力されています。