iconv_strpos

(PHP 5, PHP 7)

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

説明

iconv_strpos ( string $haystack , string $needle [, int $offset = 0 [, string $charset = ini_get("iconv.internal_encoding") ]] ) : int

needlehaystack の中で最初に現れる位置を探します。

strpos() の返り値は needle が見つかった位置の 先頭からのバイト数でしたが、それとは異なり iconv_strpos() の返り値は needle が見つかった 位置の先頭からの文字数となります。文字数は charset で指定された文字セットに基づいて 数えられます。

パラメータ

haystack

文字列全体。

needle

検索する文字列。

offset

オプションの offset パラメータは 検索を開始する位置を指定します。 負のオフセットは、文字列の末尾からのオフセットと解釈されます。

charset

charset パラメータが指定されなかった場合、 string のエンコードは iconv.internal_encoding であると判断されます。

haystackneedle が文字列でない場合、文字列に変換され、文字が並んだ値として適用されます。

返り値

needlehaystack の中で最初に現れる位置を探します。

もし needle が見つからなかった場合、 iconv_strpos()FALSE を返します。

警告

この関数は論理値 FALSE を返す可能性がありますが、FALSE として評価される値を返す可能性もあります。 詳細については 論理値の セクションを参照してください。この関数の返り値を調べるには ===演算子 を 使用してください。

変更履歴

バージョン 説明
7.1.0 負の offset をサポートするようになりました。

参考

  • strpos() - 文字列内の部分文字列が最初に現れる場所を見つける
  • iconv_strrpos() - 文字列が最後に現れる場所を見つける
  • mb_strpos() - 文字列の中に指定した文字列が最初に現れる位置を見つける