関数・クラス解説

strstr

version:PHP 4, PHP 5, PHP 7 (公式)

文字列が最初に現れる位置を見つける

公式リファレンス

書式

strstr ( string $haystack , mixed $needle [, bool $before_needle = FALSE ] ) : string

説明

haystack の中で needle が最初に現れる場所を含めてそこから文字列の終わりまでを返します。

注意:

この関数は大文字小文字を区別することに注意してください。 大文字小文字を区別しない検索を行う場合は、stristr() を使用してください。

注意:

もし特定の haystack に needle があるかどうかを調べるだけの場合、 より高速でメモリ消費も少ない strpos() を代わりに使用してください。

パラメータ

haystack
入力文字列。
needle
needle が文字列でない場合、 数値に変換され、文字の通常の値として扱われます。 この振る舞いは PHP 7.3.0 以降では推奨されないので、 この機能を使用しないことを強く推奨します。 意図した動作に依存する場合、 needle を string に明示的にキャストするか、 明示的に chr() 関数を呼び出すべきでしょう。
before_needle
TRUE にすると、strstr() の返り値は、haystack の中で最初に needle があらわれる箇所より前の部分となります (needle は含めません)。

返値

部分文字列を返します。 needle が見つからない場合は FALSE を返します。

更新履歴

バージョン 説明
7.3.0 needle に int を渡すことは非推奨になりました。

サンプル

例1 strstr() の例

$email  = 'name@example.com'; $domain = strstr($email, '@'); echo $domain; // @example.com と表示します $user = strstr($email, '@', true); // PHP 5.3.0 以降 echo $user; // name と表示します

参考

  • stristr() - 大文字小文字を区別しない strstr
  • strrchr() - 文字列中に文字が最後に現れる場所を取得する
  • strpos() - 文字列内の部分文字列が最初に現れる場所を見つける
  • strpbrk() - 文字列の中から任意の文字を探す
  • preg_match() - 正規表現によるマッチングを行う
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール