strpbrk

 

C

编译器支持

语言

头文件

类型支持

程序实用程序

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用程序

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

字符串库

字节字符串

多字节字符串

宽字符串

 

以 null 结尾的字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换为和从数字格式
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字符串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字符串检查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
其他
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定义在头文件 <string.h> 中
char *strpbrk( const char *dest, const char *breakset );	(1)
/*QChar*/ *strpbrk( /*QChar*/ *dest, const char *breakset );	(2)	(自 C23)

1 ) 扫描由 dest 指向的以 null 结尾的字节字符串，查找由 breakset 指向的以 null 结尾的字节字符串中的任何字符，并返回指向该字符的指针。

2) 与 (1) 等效的类型通用函数。设 T 为非限定字符对象类型。

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

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

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

参数

dest	-	指向要分析的以 null 结尾的字节字符串的指针
breakset	-	指向包含要搜索的字符的以 null 结尾的字节字符串的指针

返回值

指向 dest 中第一个也位于 breakset 中的字符的指针，如果不存在这样的字符，则为 null 指针。

注释

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

示例

运行此代码

#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); // find separator
       if(str) str += strspn(str, sep); // skip separator
       ++cnt; // increment word count
    }
    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: TBD)

• C11 标准 (ISO/IEC 9899:2011)

• 7.24.5.4 strpbrk 函数 (p: 368)

• C99 标准 (ISO/IEC 9899:1999)

• 7.21.5.4 strpbrk 函数 (p: 331)

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

• 4.11.5.4 strpbrk 函数

另请参见

strcspn	返回由不包含在另一个字节字符串中的字符组成的最大初始段的长度 仅包含在另一个字节字符串中未找到的字符 (函数)
strchr	查找字符的第一次出现 (函数)
strtokstrtok_s (C11)	在字节字符串中查找下一个标记 (函数)
C++ 文档 for strpbrk