std:: regex_token_iterator

std::regex_token_iterator は読み取り専用の LegacyForwardIterator であり、基となる文字シーケンス内の正規表現の各マッチにおける個々の部分マッチにアクセスします。また、指定された正規表現にマッチしなかったシーケンスの部分にアクセスするためにも使用できます（例：トークナイザーとして）。

構築時には std::regex_iterator を構築し、各インクリメント時には現在のmatch_resultsから要求された部分マッチを順次処理し、最後の部分マッチから離れるインクリメント時には基盤となる std::regex_iterator を進める。

デフォルトで構築された std::regex_token_iterator は終端イテレータです。有効な std::regex_token_iterator が最後のマッチの最後のサブマッチに到達した後にインクリメントされると、終端イテレータと等しくなります。これ以降にデリファレンスやインクリメントを行うと未定義動作を引き起こします。

シーケンス終端イテレータになる直前で、 std::regex_token_iterator は suffix iterator になる可能性があります。これは、要求された部分マッチインデックスのリストにインデックス - 1 （非マッチフラグメント）が含まれている場合です。このようなイテレータをデリファレンスすると、最後のマッチとシーケンス終端の間の文字シーケンスに対応するmatch_resultsが返されます。

std::regex_token_iteratorの典型的な実装は、基盤となる std::regex_iterator 、要求された部分マッチインデックスのコンテナ（例： std:: vector < int > ）、部分マッチのインデックスと等しい内部カウンタ、現在のマッチの現在の部分マッチを指す std::sub_match へのポインタ、および最後にマッチしなかった文字シーケンス（トークナイザーモードで使用）を含む std::match_results オブジェクトを保持します。

型要件

特殊化

一般的な文字シーケンス型に対するいくつかの特殊化が定義されています：

メンバー型

メンバー関数

注記

プログラマーの責任として、イテレータのコンストラクタに渡された std::basic_regex オブジェクトがイテレータよりも長く生存することを保証しなければなりません。なぜなら、イテレータは std::regex_iterator を保持しており、これは正規表現へのポインタを保持しているため、正規表現が破棄された後にイテレータをインクリメントすると未定義動作が発生します。

例

#include <algorithm>
#include <fstream>
#include <iostream>
#include <iterator>
#include <regex>
int main()
{
    // トークン化（非マッチ部分）
    // 正規表現は2回のみマッチすることに注意。3番目の値を取得するとき、
    // イテレータはサフィックスイテレータとなる
    const std::string text = "Quick brown fox.";
    const std::regex ws_re("\\s+"); // 空白文字
    std::copy(std::sregex_token_iterator(text.begin(), text.end(), ws_re, -1),
              std::sregex_token_iterator(),
              std::ostream_iterator<std::string>(std::cout, "\n"));
    std::cout << '\n';
    // 最初のサブマッチを反復処理
    const std::string html = R"(<p><a href="http://google.com">google</a> )"
                             R"(< a HREF ="http:https://ja.cppreference.net">cppreference</a>\n</p>)";
    const std::regex url_re(R"!!(<\s*A\s+[^>]*href\s*=\s*"([^"]*)")!!", std::regex::icase);
    std::copy(std::sregex_token_iterator(html.begin(), html.end(), url_re, 1),
              std::sregex_token_iterator(),
              std::ostream_iterator<std::string>(std::cout, "\n"));
}

Quick
brown
fox.
http://google.com
https://ja.cppreference.net

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

1. ↑ iterator_category はこの解決策によって変更されませんでした。なぜなら、これを std::input_iterator_tag に変更すると、既存のコードの多くが破壊される可能性があるためです。