strstr

在头文件 `<string.h>` 中定义
char* strstr( const char* str, const char* substr );	(1)
/QChar/* strstr( /QChar/* str, const char* substr );	(2)	(从 C23 开始)

1) 在由 substr 指向的以空字符结尾的字节字符串中查找由 str 指向的以空字符结尾的字节字符串的首次出现。不比较结束的空字符。

2) 与 (1) 等效的类型泛型函数。设 T 为一个未限定的字符对象类型。

如果 str 的类型为 const T*，则返回类型为 const char*。
否则，如果 str 的类型为 T*，则返回类型为 char*。
否则，行为未定义。

如果每个这些泛型函数的宏定义都被抑制以访问实际函数（例如，如果使用 (strstr) 或函数指针），则实际函数声明 (1) 变得可见。

如果 str 或 substr 不是指向以空字符结尾的字节字符串的指针，则行为未定义。

[编辑] 参数

str	-	指向要检查的以空字符结尾的字节字符串的指针
substr	-	指向要搜索的以空字符结尾的字节字符串的指针

[编辑] 返回值

指向在 str 中找到的子字符串的第一个字符的指针，如果未找到此类子字符串，则为一个空指针。如果 substr 指向一个空字符串，则返回 str。

[编辑] 示例

运行此代码

#include <stdio.h>
#include <string.h>
 
void find_str(char const* str, char const* substr)
{
    char const* pos = strstr(str, substr);
    if (pos)
        printf(
            "Found the string [%s] in [%s] at position %td\n",
            substr, str, pos - str
        );
    else
        printf(
            "The string [%s] was not found in [%s]\n",
            substr, str
        );
}
 
int main(void)
{
    char const* str = "one two three";
    find_str(str, "two");
    find_str(str, "");
    find_str(str, "nine");
    find_str(str, "n");
 
    return 0;
}

输出

Found the string [two] in [one two three] at position 4
Found the string [] in [one two three] at position 0
The string [nine] was not found in [one two three]
Found the string [n] in [one two three] at position 1

[编辑] 参考文献

C23 标准 (ISO/IEC 9899:2024)

7.24.5.7 strstr 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.24.5.7 strstr 函数 (p: 269)

C11 标准 (ISO/IEC 9899:2011)

7.24.5.7 strstr 函数 (p: 369)

C99 标准 (ISO/IEC 9899:1999)

7.21.5.7 strstr 函数 (p: 332)

C89/C90 标准 (ISO/IEC 9899:1990)

4.11.5.7 strstr 函数

[编辑] 另请参见

strchr	查找字符的首次出现 (函数) [编辑]
strrchr	查找字符的最后一次出现 (函数) [编辑]
C++ 文档用于 strstr

编译器支持
语言
头文件
类型支持
程序实用程序
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用程序
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.com

命名空间

变体

视图

操作