wcstok, wcstok_s

wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t** ptr );

wchar_t* wcstok( wchar_t*  restrict str, const wchar_t* restrict delim,
                 wchar_t** restrict ptr );

wchar_t* wcstok_s( wchar_t* restrict str, rsize_t* restrict strmax,
                   const wchar_t* restrict delim, wchar_t** restrict ptr);

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

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

• そのようなワイド文字が見つからなかった場合、str にはトークンが一つだけであり、それ以降の 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'

参考文献

関連項目