std::wcstok
来自cppreference.com
在标头 <cwchar> 定义 | ||
wchar_t* wcstok(wchar_t* str, constwchar_t* delim, wchar_t** ptr); | ||
寻找 str 所指向的空终止宽字符串中的下个记号。以 delim 所指向的空终止宽字符串鉴别分隔符。
此函数被设计为调用多次以从同一字符串获得相继的记号。
- 若 str != nullptr，则调用被当做
std::wcstok首次对此具体宽字符的调用。函数搜索首个不含于 delim 的字符。
- 若找不到这种宽字符，则 str 中完全无记号，而函数返回空指针。
- 若找到这种宽字符，则它是记号起始。然后函数从该点搜索首个含于delim 的宽字符。
- 若找不到这种宽字符，则 str 只有一个记号，而对
std::wcstok的将来调用将返回空指针。 - 若找到这种宽字符，则以空宽字符 L'\0'替换它，并存储分析状态（典型地为指向后一宽字符的指针）于用户提供的位置 *ptr。
- 若找不到这种宽字符，则 str 只有一个记号，而对
- 然后函数返回指向记号起始的指针
- 若 str ==NULL，则调用被当作对
std::wcstok的后继调用：函数从带同一 *ptr 的先前调用所留下的位置开始持续。行为与如同将指向后随上次检测的记号的宽字符的指针作为 str 传递相同。
- 若 str != nullptr，则调用被当做
目录 |
[编辑]参数
| str | - | 指向要记号化的空终止宽字符串的指针 |
| delim | - | 指向标识分隔符的空终止宽字符串的指针 |
| ptr | - | 指向 wchar_t* 类型对象的指针，wcstok 以之存储分析器的内部状态 |
[编辑]返回值
返回指向下个记号起始的指针，或若无更多记号则为空指针。
[编辑]注解
此函数是破坏性的：它向字符串 str 的元素中写入 L'\0' 字符。特别是，宽字符串字面量不能用作 std::wcstok 的首个实参。
不同于 std::strtok，此函数不更新静态存储：它存储分析状态于用户提供的位置。
不同于大多数其他记号化器，std::wcstok 中的分隔符对于后继记号可以是不同的，且它甚至能依赖于先前记号的内容。
[编辑]示例
运行此代码
#include <cwchar>#include <iostream> int main(){wchar_t input[100]= L"A bird came down the walk";wchar_t* buffer;wchar_t* token = std::wcstok(input, L" ", &buffer);while(token){std::wcout<< token <<'\n'; token = std::wcstok(nullptr, L" ", &buffer);}}
输出：
A bird came down the walk
[编辑]参阅
| 寻找字节字符串中的下个记号 (函数) | |
wcstok 的 C 文档 | |
