std::wcstok

ヘッダ `<cwchar>` で定義
wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t ** ptr);

str で指されるヌル終端のワイド文字列から次のトークンを検索します。区切り文字は、delim で指されるヌル終端のワイド文字列によって識別されます。

この関数は、同じ文字列から連続したトークンを取得するために複数回呼び出されるように設計されています。

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

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

そのようなワイド文字が見つからなかった場合、str にはトークンが 1 つしかなく、後続の std::wcstok の呼び出しはヌルポインタを返します。
そのようなワイド文字が見つかった場合、それはヌルワイド文字 L'\0' に置き換えられ、パーサーの状態（通常は次のワイド文字へのポインタ）は、ユーザー提供の場所 *ptr に格納されます。

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

もし str == nullptr ならば、この呼び出しは std::wcstok への後続の呼び出しとして扱われます：関数は、前の呼び出しで停止した場所から、同じ *ptr を使用して続行します。動作は、最後の検出されたトークンの後のワイド文字へのポインタが str として渡された場合と同じです。

#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	バイト文字列内の次のトークンを見つける (関数) [編集]
C のドキュメント (wcstok)

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作

std::wcstok

目次

[編集] パラメータ

[編集] 戻り値

[編集] 注意

[編集] 例

[編集] 関連項目

ナビゲーション

ツールボックス

str	-	トークン化するヌル終端のワイド文字列へのポインタ
delim	-	区切り文字を識別するヌル終端のワイド文字列へのポインタ
ptr	-	wchar_t* 型のオブジェクトへのポインタ。wcstok は内部状態を格納するためにこれを使用します。