# 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() - 执行匹配正则表达式

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