strpbrk

来自cppreference.com
< c‎ | string‎ | byte
在标头 <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) 即变得可见。

destbreakset 不是指向空终止字节字符串的指针,则行为未定义。

参数

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

返回值

指向 dest 中首个亦在 breakset 中的字符的指针,或若这种字符不存在则为空指针。

注解

名称代表“字符串指针打断 (string pointer break) ”,因为它返回指向首个分隔符(“打断”)的指针。

示例

#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("共有 %d 个单词\n", cnt);
}

输出:

共有 5 个单词

引用

  • C23 标准(ISO/IEC 9899:2024):
  • 7.24.5.4 The strpbrk function (第 TBD 页)
  • C17 标准(ISO/IEC 9899:2018):
  • 7.24.5.4 The strpbrk function (第 TBD 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 7.24.5.4 The strpbrk function (第 368 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.21.5.4 The strpbrk function (第 331 页)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 4.11.5.4 The strpbrk function

参阅

返回另一个字符串所不具有的字符分割的最大起始段长度
(函数)
查找字符的首次出现
(函数)
查找字节字符串中的下一个记号
(函数)