str_contains

(PHP 8)

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

説明

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

needlehaystack に含まれるかを調べます。 大文字小文字は区別されます。

パラメータ

haystack

検索対象の文字列

needle

haystack で調べる部分文字列

戻り値

haystackneedle が含まれていた場合 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() - 正規表現によるマッチングを行う

関連キーワード:  部分, 指定, string, haystack, 大文字, 小文字, 区別, 位置, contains, 最後