wcstok, wcstok_s

定义于头文件 `<wchar.h>`
	(1)
wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t** ptr );			(C95 起) (C99 前)
wchar_t* wcstok( wchar_t* restrict str, const wchar_t* restrict delim, wchar_t** restrict ptr );			(C99 起)
wchar_t* wcstok_s( wchar_t* restrict str, rsize_t* restrict strmax, const wchar_t* restrict delim, wchar_t** restrict ptr);		(2)	(C11 起)

1) 在 str 所指向的空终止宽字符串中查找下一个标记。分隔符字符由 delim 所指向的空终止宽字符串标识。

此函数设计为多次调用，以从同一字符串中获取连续的标记。

如果 str != NULL，则此调用被视为对该特定宽字符串的 wcstok 的首次调用。该函数搜索不包含在 delim 中的第一个宽字符。

如果未找到此类宽字符，则 str 中根本没有标记，并且该函数返回空指针。
如果找到此类宽字符，则它是标记的开始。然后，该函数从该点开始搜索包含在 delim 中的第一个宽字符。

如果未找到此类宽字符，则 str 只有一个标记，并且将来对 wcstok 的调用将返回空指针
如果找到此类宽字符，则它被空宽字符 L'\0'替换，并且解析器状态（通常是指向以下宽字符的指针）存储在用户提供的位置 *ptr 中。

然后，该函数返回指向标记开头的指针

如果 str == NULL，则此调用被视为对 wcstok 的后续调用：该函数从上次调用中 *ptr 离开的位置继续。行为与将指向最后一个检测到的标记之后的宽字符的指针作为 str 传递相同。

2) 与 (1) 相同，不同之处在于，在每个步骤中，将 str 中剩余要查看的字符数写入 *strmax。重复调用（使用空 str）必须传递 strmax 和 ptr 以及先前调用存储的值。此外，以下错误在运行时检测到，并调用当前安装的约束处理函数，而不在 ptr 指向的对象中存储任何内容

strmax、delim 或 ptr 是空指针
在非初始调用（使用空 str）时，*ptr 是空指针
在首次调用时，*strmax 为零或大于 RSIZE_MAX / sizeof(wchar_t)
搜索标记的结尾到达源字符串的结尾（由 *strmax 的初始值衡量），而没有遇到空终止符

与所有边界检查函数一样，只有当实现定义了 __STDC_LIB_EXT1__ 并且用户在包含 <wchar.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时，才能保证 wcstok_s 可用。

str	-	指向要标记化的空终止宽字符串的指针
delim	-	指向标识分隔符的空终止宽字符串的指针
ptr	-	指向 wchar_t* 类型的对象的指针，`wcstok` 和 `wcstok_s` 都使用它来存储解析器的内部状态
strmax	-	指向最初保存 str 大小的对象的指针：wcstok_s 存储剩余要检查的字符数

[编辑] 返回值

返回指向下一个标记的开头的指针；如果没有更多标记，则返回空指针。

[编辑] 注意

此函数是破坏性的：它在字符串 str 的元素中写入 L'\0' 字符。特别是，宽字符串字面量不能用作 wcstok 的第一个参数。

与 strtok 不同，wcstok 不更新静态存储：它将解析器状态存储在用户提供的位置。

与大多数其他标记器不同，wcstok 中的分隔符对于每个后续标记可以不同，甚至可以取决于先前标记的内容。

Windows CRT 中 wcstok_s 的实现与 C 标准不兼容，它只是 wcstok 的别名。

[编辑] 示例

运行此代码

#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    wchar_t input[] = L"A bird came down the walk";
    printf("Parsing the input string '%ls'\n", input);
    wchar_t* buffer;
    wchar_t* token = wcstok(input, L" ", &buffer);
    while (token)
    {
        printf("%ls\n", token);
        token = wcstok(NULL, L" ", &buffer);
    }
 
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof input / sizeof *input; ++n)
        input[n] ? printf("%lc", input[n]) : printf("\\0");
    puts("'");
}

输出

Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'

[编辑] 参考文献

C11 标准 (ISO/IEC 9899:2011)

7.29.4.5.7 wcstok 函数 (p: 437-438)

K.3.9.2.3.1 wcstok_s 函数 (p: 645-646)

C99 标准 (ISO/IEC 9899:1999)

7.24.4.5.7 wcstok 函数 (p: 383-384)

[编辑] 参见

strtokstrtok_s (C11)	在字节字符串中查找下一个标记 (函数) [编辑]
C++ 文档，关于 wcstok

编译器支持
语言
头文件
类型支持
程序工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.cn

命名空间

变体

视图

操作