C strspn() 语法
strspn() 是 C 语言 <string.h> 标准库的一个函数，用于计算一个字符串开头连续 “包含” 指定字符集合中的字符的长度。
换句话来说，strspn() 会查找字符串中第一个不属于指定字符集合的字符，并返回该字符之前的子串长度。
语法：
strspn(str1, str2)说明：
strspn() 函数接收以下 2 个参数。
str1（const char*）：要搜索的字符串的指针。str2（const char*）：一个包含 “接受字符集合” 的字符串的指针。strspn() 函数会查找 str1 开头连续的字符，这些字符必须都包含在 str2 定义的集合中。
strspn(str1, str2) 会从 str1 的第一个字符开始，逐个检查字符是否属于 str2 中的字符集合。只要当前字符在 str2 中找到，那么 strspn() 就继续检查 str1 的下一个字符。当遇到 str1 中的字符不在 str2 中，或者到达 str1 的终止符 '\0' 时，检查才会停止。
strspn() 函数会返回一个 size_t 类型的值，该值是 str1 开头由 str2 中字符组成的 “最长连续段的长度” （不包括 str1 中的终止符）。
- 如果 str1 的第一个字符就不在 str2 的字符集合中，则 strspn() 返回 0。
- 如果 str1 中的所有字符都在 str2 的字符集合中（直到 str1 的终止符），则 strspn() 返回 str1 的长度。
提示:
- strspn 是 “string span” 的缩写。
- strspn() 的 “好基友” 是 strcspn()。strcspn() 会计算字符串开头连续 “不包含” 指定字符集合中的字符的长度。
C strspn() 摘要
| 使用频率 | 中 |
|---|---|
| 修改字符串 | 否 |
| 官方文档 | 查看 |
C strspn() 示例
接下来，我们通过几个简单的例子来讲解一下 C strspn() 函数是如何使用的。
示例 1：strspn() 查找字符串开头只包含数字的长度
#include <stdio.h>
#include <string.h>
int main(void)
{
const char str[] = "12345abcde";
const char accept_chars[] = "0123456789"; // 接受的字符集合：数字
size_t length = strspn(str, accept_chars);
printf("%zu\n", length);
return 0;
}运行结果如下。
5分析：
在这个例子中，我们尝试使用 strspn() 函数来查找一个字符串中开头连续的数字字符的长度。strspn() 函数会从字符串开头开始检查，直到遇到第一个非数字字符为止，然后返回之前连续的数字字符的长度。
示例 2：strspn() 查找字符串开头只包含字母的长度
#include <stdio.h>
#include <string.h>
int main(void)
{
const char str[] = "lvyenet666";
// 接受的字符集合：字母
const char accept_chars[] = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
size_t length = strspn(str, accept_chars);
printf("%zu\n", length);
return 0;
}运行结果如下。
7分析：
在这个例子中，我们尝试使用 strspn() 函数来查找一个字符串中开头连续的字母字符的长度。其中，strspn() 接受的字符集合是 “所有大小写字母”。
示例 3：strspn() 查找字符串开头不包含任何接受字符
#include <stdio.h>
#include <string.h>
int main(void)
{
const char str[] = " abcdef";
const char accept_chars[] = "abcdefghijklmnopqrstuvwxyz"; // 接受的字符集合：小写字母
size_t length = strspn(str, accept_chars);
printf("%zu\n", length);
return 0;
}运行结果如下。
0分析：
由于字符串 "abcdef" 的第一个字符是空格，而空格不在接受字符集合 "abcdefghijklmnopqrstuvwxyz" 中，因此 strspn() 返回 0。
strspn() 的应用场景
在实际开发中，strspn() 函数经常用于需要确定一个字符串开头符合特定字符模式长度的场景，比如：
- 验证字符串的前缀是否只包含特定的字符集合。
- 解析字符串时，跳过开头的空白字符或特定符号。
- 检查用户输入的字符串是否符合特定的格式要求（例如，开头是否只包含数字或字母）。
- 结合其他字符串函数（如 strcspn() 或指针算术）来提取字符串的特定部分。
