iconv_strpos

(PHP 5, PHP 7, PHP 8)

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

iconv_strpos(
    string $haystack,
    string $needle,
    int $offset = 0,
    ?string $encoding = null
): int|false

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

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

haystack: 文字列全体。
needle: 検索する文字列。
offset: オプションの offset パラメータは検索を開始する位置を指定します。負のオフセットは、文字列の末尾からのオフセットと解釈されます。
encoding: encoding パラメータが指定されなかった場合、もしくは null の場合、 string のエンコードは iconv.internal_encoding であると判断されます。

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

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

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

警告

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

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

関連キーワード: 　最初, 場所, iconv, strpos, 位置, encoding, haystack, string, offset, 関数