文字列
haystack
の中で、
needle
が最初に現れた位置を数字で返します。
strrpos()
とは異なり、この関数は
needle
パラメータとして文字列全体をとり、そ の文字列全体が検索対象となります。
needle
が見つからない場合は
FALSE
を返します。
注意 "位置0で文字が見つかった"と"文字がみつからなかった"という返り値 は混同しやすいです。これらを区別するには、次のようにします。
// PHP 4.0b3以降の場合: $pos = strpos($mystring, "b"); if ($pos === false) { // 注意: 等号が3つです。 // 見つかりませんでした... } // 4.0b3より前のバージョンの場合: $pos = strpos($mystring, "b"); if (!is_string($pos)) { // 見つかりませんでした... }
needle
が文字列でない場合は数値に 変換されて、その結果が検索対象の文字コードとして適用されます。
オプションの
offset
パラメータにより
haystack
のどの文字から検索を開始するかを 指定することが可能です。 この場合でも、返される位置は
haystack
の先頭に 対する相対位置です。
strrpos()
,
strrchr()
,
substr()
,
stristr()
,
strstr()
も参照下さい。