std::wcstok

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

空终止宽字符串

函数
字符操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11) wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
转换到数值格式
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
字符串操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
数组操作
wmemcpy
wmemmove
wmemcmp
wmemchr
wmemset

 

定义于头文件 <cwchar>
wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t ** ptr);

寻找 str 所指向的空终止宽字符串中的下个记号。以 delim 所指向的空终止宽字符串鉴别分隔符。

此函数被设计为调用多次以从同一字符串获得相继的记号。

• 若 str != NULL ，则调用被当做 std::wcstok 首次对此具体宽字符的调用。函数搜索首个不含于 delim 的字符。

• 若找不到这种宽字符，则 str 中完全无记号，而函数返回空指针。
• 若找到这种宽字符，则它是记号起始。然后函数从该点搜索首个含于 delim 的宽字符。

• 若找不到这种宽字符，则 str 只有一个记号，而对 std::wcstok 的将来调用将返回空指针
• 若找到这种宽字符，则以空宽字符 L'\0' 替换它，并存储分析状态（典型地为指向后一宽字符的指针）于用户提供位置 *ptr 。

• 然后函数返回指向记号起始的指针

• 若 str == NULL ，则调用被当作对 std::wcstok 的后继调用：函数从带同一 *ptr 的先前调用所留下的位置开始持续。行为与如同将指向后随上次检测的记号的宽字符的指针作为 str 传递相同。

参数

str	-	指向要记号化的空终止宽字符串的指针
delim	-	指向标识分隔符的空终止宽字符串的指针
ptr	-	指向 wchar_t* 类型对象的指针， wcstok 以之存储分析器的内部状态

返回值

返回指向下个记号起始的指针，或若无更多记号则为空指针。

注意

此函数是破坏性的：它写入 L'\0' 字符于字符串 str 的元素。特别是，宽字符串字面量不能用作 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

参阅

strtok

寻找字节字符串中的下个记号 (函数)