Namespaces
Variants

strpbrk

From cppreference.net
< c ‎ | string ‎ | byte
C
Strings library
Null-terminated byte strings
Functions
Character manipulation
Conversions to and from numeric formats
String manipulation
String examination
Memory manipulation
Miscellaneous
(C11) (C11)
定义于头文件 <string.h>
char * strpbrk ( const char * dest, const char * breakset ) ;
(1)
/*QChar*/ * strpbrk ( /*QChar*/ * dest, const char * breakset ) ;
(2) (C23 起)
1 ) 扫描由 dest 指向的以空字符结尾的字节字符串，查找由 breakset 指向的以空字符结尾的字节字符串中的任意字符，并返回指向该字符的指针。
2) 与 (1) 等效的类型泛型函数。令 T 为无限定字符对象类型。
  • 若 dest 的类型为 const T * ，则返回类型为 const char * 。
  • 否则，若 dest 的类型为 T * ，则返回类型为 char * 。
  • 否则行为未定义。
若通过抑制这些泛型函数的宏定义来访问实际函数（例如使用 ( strpbrk ) 或函数指针），则实际函数声明 (1) 将可见。

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

目录

参数

dest - 指向待分析的空终止字节字符串的指针
breakset - 指向包含待搜索字符的空终止字节字符串的指针

返回值

指向 dest 中首个同时存在于 breakset 中的字符的指针，若不存在此类字符则返回空指针。

注释

该名称代表“字符串指针中断”，因为它返回指向第一个分隔符（“中断”）字符的指针。

示例

运行此代码 
#include <stdio.h>
#include <string.h>
int main(void)
{
    const char* str = "hello world, friend of mine!";
    const char* sep = " ,!";
    unsigned int cnt = 0;
    do
    {
       str = strpbrk(str, sep); // 查找分隔符
       if(str) str += strspn(str, sep); // 跳过分隔符
       ++cnt; // 增加单词计数
    }
    while(str && *str);
    printf("There are %u words\n", cnt);
}

输出： 

There are 5 words

参考文献

  • C23 标准 (ISO/IEC 9899:2024):
  • 7.24.5.4 strpbrk 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018):
  • 7.24.5.4 strpbrk 函数 (p: 待定)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.24.5.4 strpbrk 函数 (p: 368)
  • C99标准（ISO/IEC 9899:1999）：
  • 7.21.5.4 strpbrk函数（页码：331）
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 4.11.5.4 strpbrk 函数

参见

返回仅包含不在另一个字节字符串中出现的字符的
最大起始段的长度
(函数)
查找字符的首次出现
(函数)
(C11)
查找字节字符串中的下一个标记
(函数)
C++ 文档 for strpbrk