str_contains

(PHP 8)

str_contains — 确定字符串是否包含指定子串

说明

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

执行大小写区分的检查，表明 needle 是否包含在 haystack 中。

参数

haystack: 在其中搜索的字符串。
needle: 要在 haystack 中搜索的子串。

返回值

如果 needle 在 haystack 中，返回 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() - 执行匹配正则表达式