wcstok, wcstok_s

• str ! = NULL の場合、この特定のワイド文字列に対する wcstok の最初の呼び出しとして扱われます。関数は delim に含まれ ない 最初のワイド文字を検索します。

• そのようなワイド文字が見つからなかった場合、 str にはトークンが全く存在せず、関数はヌルポインタを返します。
• そのようなワイド文字が見つかった場合、それは トークンの開始位置 となります。関数はその位置から、 delim に含まれる最初のワイド文字を検索します。

• そのようなワイド文字が見つからなかった場合、 str にはトークンが1つしか存在せず、将来の wcstok の呼び出しはヌルポインタを返します。
• そのようなワイド文字が見つかった場合、それはヌルワイド文字 L ' \0 ' に 置換 され、パーサーの状態（通常は次のワイド文字へのポインタ）はユーザー提供の場所 * ptr に保存されます。

• その後、関数はトークンの開始位置へのポインタを返します。

• str == NULL の場合、 wcstok の後続の呼び出しとして扱われます：関数は前回の呼び出しで中断した位置から同じ * ptr を使用して継続します。この動作は、最後に検出されたトークンの次のワイド文字へのポインタが str として渡された場合と同じです。

パラメータ

戻り値

次のトークンの先頭へのポインタを返します。トークンがこれ以上存在しない場合はヌルポインタを返します。

注記

この関数は破壊的です：文字列 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'

参考文献

関連項目