strcspn

定义于头文件 `<string.h>`
size_t strcspn( const char dest, const char src );

返回 dest 所指向的空终止字节字符串的最大起始段长度，该段只由 src 所指向的空终止字节字符串中找不到的字符组成。

若 dest 或 src 不是指向空终止字节字符串的指针，则行为未定义。

参数

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

返回值

仅由 src 所指向的空终止字节字符串中找不到的字符组成的最大起始段长度。

注意

函数名代表“补集段 (complementary span) ”，因为函数搜索 src 中找不到的字符，即 src 的补集。

示例

运行此代码

#include <string.h>
#include <stdio.h>
 
int main(void)
{
    const char *string = "abcde312$#@";
    const char *invalid = "*$#";
 
    size_t valid_len = strcspn(string, invalid);
    if(valid_len != strlen(string))
       printf("'%s' contains invalid chars starting at position %zu\n",
               string, valid_len);
}

输出：

'abcde312$#@' contains invalid chars starting at position 8

引用

C11 standard (ISO/IEC 9899:2011):

7.24.5.3 The strcspn function (p: 368)

C99 standard (ISO/IEC 9899:1999):

7.21.5.3 The strcspn function (p: 331)

C89/C90 standard (ISO/IEC 9899:1990):

4.11.5.3 The strcspn function

参阅

strspn	返回由另一个字符串中的字符分割的最大起始段长度 (函数)
wcscspn (C95)	返回仅由不出现于另一个宽字符串中的宽字符分隔的最长首段长度 (函数)
strpbrk	查找一个字符串中的任意一个字符在另一个字符串中的首个位置 (函数)

语言
头文件
类型支持
程序工具
变参数函数支持
动态内存管理
错误处理
日期和时间工具
字符串库
算法
数值
输入/输出支持
本地化支持
线程支持 (C11)
原子操作 (C11)
技术规范