指定された部分文字列が、文字列に含まれるかを調べる

# str_contains

(PHP 8)

str_contains — 指定された部分文字列が、文字列に含まれるかを調べる

### 説明

function str_contains(string `$haystack`, string `$needle`): bool

`needle` が `haystack` に含まれるかを調べます。 大文字小文字は区別されます。

### パラメータ

`haystack`

  検索対象の文字列

`needle`

  `haystack` で調べる部分文字列

### 戻り値

`haystack` に `needle` が含まれていた場合 `true` そうでない場合、`false` を返します。

### 例

例1 空文字列 `''` を使った場合

    <?php
    if (str_contains('abc', '')) {
        echo "Checking the existence of the empty string will always return true";
    }
    ?>

上の例の出力は以下となります。

    Checking the existence of the empty string will always return true

例2 大文字小文字の区別

    <?php
    $string = 'The lazy fox jumped over the fence';

    if (str_contains($string, 'lazy')) {
        echo "The string 'lazy' was found in the string\n";
    }

    if (str_contains($string, 'Lazy')) {
        echo 'The string "Lazy" was found in the string';
    } else {
        echo '"Lazy" was not found because the case does not match';
    }

    ?>

上の例の出力は以下となります。

    The string 'lazy' was found in the string
    "Lazy" was not found because the case does not match

### 注意

> 注意: この関数はバイナリデータに対応しています。

### 参考

- str_ends_with() - 文字列が、指定された文字列で終わるかを調べる。
- str_starts_with() - 文字列が指定された部分文字列で始まるかを調べる
- stripos() - 大文字小文字を区別せずに文字列が最初に現れる位置を探す
- strrpos() - 文字列中に、ある部分文字列が最後に現れる場所を探す
- strripos() - 文字列中で、特定の(大文字小文字を区別しない)文字列が最後に現れた位置を探す
- strstr() - 文字列が最初に現れる位置を見つける
- strpbrk() - 文字列の中から任意の文字を探す
- substr() - 文字列の一部分を返す
- preg_match() - 正規表現によるマッチングを行う

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open