strpos

strpos -- 文字列が最初に現れる場所を見つける

説明

int strpos(string haystack, string needle, int [offset] );

文字列 haystack の中で、 needleが最初に現れた位置を数字で返します。 strrposとは異なり、この関数は needle パラメータとして文字列全体をとり、 その文字列全体が検索対象となります。

needleが見つからない場合はfalseを返します。

注意: "character found at position 0" および "character not found" の場合の返り値は混同しやすいです。 この違いを見分けるには次のようにします。


 // PHP 4.0b3 以降
 $pos = strpos("b", $mystring);
 if ($pos === false) { // 注意: 等号が3つ続いています
     // not found...
 }
 
 // 4.0b3 より前のバージョンでは、
 $pos = strpos("b", $mystring);
 if (is_string($pos) && !$pos) {
     // 見つかりませんでした...
 }
 

needle が文字列でない場合は数値に 変換されて、その結果が検索対象の文字コードとして適用されます。

オプションの offset パラメータにより haystack のどの文字から検索を開始するかを 指定することが可能です。 この場合でも、返される位置は haystack の先頭に 対する相対位置です。

strrpos, strrchr, substr, stristr, strstr も参照下さい。