std::strtok
来自cppreference.com
在标头 <cstring> 定义 | ||
char* strtok(char* str, constchar* delim ); | ||
记号化空终止字节字符串。
对 std::strtok 进行的一系列调用会将 str 指向的字符串拆分为记号序列，记号之间以 delim 中的某个字符分隔。调用序列中的每次调用都有一个搜索目标 ：
- 如果 str 非空，那么该调用是序列中的首次调用。搜索目标是 str 指向的空终止字节字符串。
- 如果 str 为空，那么该调用是序列中的后续调用。搜索目标由系列中的上一次调用确定。
序列中的每次调用都会在搜索目标中搜索第一个不在 delim 指向的分隔字符串 中出现的字符，每次调用中分隔字符串可以不一致。
- 如果没有找到这种字符，那么搜索目标中没有任何记号。序列中的下次调用的搜索目标保持不变。[1]
- 如果找到了这种字符，那么它就是当前记号的起始。然后
std::strtok会从此处开始搜索第一个在分隔字符串中出现的字符。- 如果没有找到这种字符，那么当前记号会持续到搜索目标的末尾。序列中的下次调用的搜索目标是空字符串。[2]
- 如果找到了这种字符，那么会用空字符覆盖它，并结束当前记号。序列中的下次调用的搜索目标从下一字符开始。
如果 str 或 delim 不是指向空终止字节字符串的指针，那么行为未定义。
目录 |
[编辑]参数
| str | - | 指向要记号化的空终止字节字符串的指针 |
| delim | - | 指向标识分隔符的空终止字节字符串的指针 |
[编辑]返回值
指向下个记号起始的指针，或若无更多记号则为空指针。
[编辑]注解
此函数是破坏性的：它在字符串 str 的元素中写入 '\0' 字符。特别是，字符串字面量不能用作 std::strtok 的首个实参。
每次对此函数的调用都会修改静态对象：它不是线程安全的。
与大多数其他记号化器不同，std::strtok 中的分隔符对于各个后继记号可以有所不同，它甚至能依赖于先前记号的内容。
[编辑]可能的实现
char* strtok(char* str, constchar* delim){staticchar* buffer; if(str != nullptr) buffer = str; buffer +=std::strspn(buffer, delim); if(*buffer =='\0')return nullptr; char*const tokenBegin = buffer; buffer +=std::strcspn(buffer, delim); if(*buffer !='\0')*buffer++='\0'; return tokenBegin;} |
这个函数的实际 C++ 库实现都委托给 C 库，其中会直接实现它（如 MUSL libc），或以它的可重入版本实现（如 GNU libc）。
[编辑]示例
运行此代码
#include <cstring>#include <iomanip>#include <iostream> int main(){char input[]="one + two * (three - four)!";constchar* delimiters ="! +- (*)";char* token = std::strtok(input, delimiters);while(token){std::cout<<std::quoted(token)<<' '; token = std::strtok(nullptr, delimiters);} std::cout<<"\n输入字符串的内容现在是：\n\"";for(std::size_t n =0; n < sizeof input;++n){if(constchar c = input[n]; c !='\0')std::cout<< c;elsestd::cout<<"\\0";}std::cout<<"\"\n";}
输出：
"one" "two" "three" "four" 输入字符串的内容现在是： "one\0+ two\0* (three\0- four\0!\0"
[编辑]参阅
| 寻找任何来自分隔符集合的字符的首个位置 (函数) | |
| 返回仅由另一字节字符串中找不到的字符组成的最大起始段的长度 (函数) | |
| 返回仅由另一字节字符串中找到的字符组成的最大起始段的长度 (函数) | |
用某个分隔符切割另一 view 所获得的子范围的 view(类模板)(范围适配器对象) | |
strtok 的 C 文档 | |
