std::wcstok
来自 cppreference.cn
| 定义于头文件 <cwchar> |
||
| wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t ** ptr); |
||
在一个由 str 指向的空终止宽字符串中查找下一个标记。分隔符字符由 delim 指向的空终止宽字符串标识。
此函数被设计为多次调用，以从同一字符串中获取连续的标记。
- 如果 str != nullptr，则此调用被视为对此特定宽字符串的
std::wcstok的首次调用。该函数搜索 不 包含在 delim 中的第一个宽字符。
- 如果未找到此类宽字符，则 str 中根本没有标记，并且该函数返回空指针。
- 如果找到此类宽字符，则它是标记的开始。然后，该函数从该点开始搜索 包含 在 delim 中的第一个宽字符。
- 如果未找到此类宽字符，则 str 只有一个标记，并且将来对
std::wcstok的调用将返回空指针。 - 如果找到此类宽字符，则它被空宽字符 L'\0'替换，并且解析器状态（通常是指向以下宽字符的指针）存储在用户提供的位置 *ptr 中。
- 如果未找到此类宽字符，则 str 只有一个标记，并且将来对
- 然后，该函数返回指向标记开始位置的指针。
- 如果 str == nullptr，则此调用被视为对
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
[编辑] 参见
| 在字节字符串中查找下一个标记 (函数) | |
| C 文档 关于 wcstok 的文档
| |
