std:: regex_iterator

std::regex_iterator は、基となる文字シーケンス内の正規表現の個々のマッチにアクセスする読み取り専用イテレータです。これは LegacyForwardIterator の要件を満たしますが、デリファレンス可能な値 a と b が a == b を満たす場合でも、 * a と * b が同じオブジェクトに束縛されない点が例外です。

構築時およびすべてのインクリメント時に、 std::regex_search を呼び出し、結果を保存します（つまり、 std:: match_results < BidirIt > の値のコピーを保存します）。最初のオブジェクトは、イテレータが構築された時点、または最初のデリファレンスが実行された時点で読み取られる可能性があります。それ以外の場合、デリファレンスは直近に取得された正規表現マッチのコピーのみを返します。

デフォルト構築された std::regex_iterator は終端イテレータです。有効な std::regex_iterator が最後のマッチに到達した後にインクリメントされると（ std::regex_search が false を返す）、それは終端イテレータと等しくなります。これに対してさらにデリファレンスやインクリメントを行うと未定義動作が発生します。

std::regex_iterator の典型的な実装は、基になるシーケンスの先頭イテレータと終端イテレータ（2つの BidirIt インスタンス）、正規表現へのポインタ（ const regex_type * ）、マッチフラグ（ std::regex_constants::match_flag_type ）、および現在のマッチ（ std:: match_results < BidirIt > ）を保持します。

型要件

特殊化

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

メンバー型

データメンバ

メンバー関数

注記

イテレータのコンストラクタに渡された std::basic_regex オブジェクトがイテレータよりも長く生存することを保証するのはプログラマの責任です。イテレータが正規表現へのポインタを保持しているため、正規表現が破棄された後にイテレータをインクリメントするとダングリングポインタにアクセスすることになります。

正規表現のマッチ部分が単なる アサーション ( ^ , $ , \b , \B ) である場合、イテレータに格納されるマッチは長さゼロのマッチ、すなわち match [ 0 ] . first == match [ 0 ] . second となります。

例

#include <iostream>
#include <iterator>
#include <regex>
#include <string>
int main()
{
    const std::string s = "Quick brown fox.";
    std::regex words_regex("[^\\s]+");
    auto words_begin = std::sregex_iterator(s.begin(), s.end(), words_regex);
    auto words_end = std::sregex_iterator();
    std::cout << "Found " << std::distance(words_begin, words_end) << " words:\n";
    for (std::sregex_iterator i = words_begin; i != words_end; ++i)
    {
        std::smatch match = *i;
        std::string match_str = match.str();
        std::cout << match_str << '\n';
    }
}

Found 3 words:
Quick
brown
fox.

不具合報告

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

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

関連項目