namespace std {
  template <class BidirectionalIterator,
            class charT = typename iterator_traits<BidirectionalIterator>::value_type,
            class traits = regex_traits<charT> >
  class regex_iterator;

  using cregex_iterator  = regex_iterator<const char*>;
  using wcregex_iterator = regex_iterator<const wchar_t*>;
  using sregex_iterator  = regex_iterator<string::const_iterator>;
  using wsregex_iterator = regex_iterator<wstring::const_iterator>;
}

概要

regex_iterator は、ある文字列に対して、指定した正規表現で検索した結果を順番に列挙する読み取り専用の前方向イテレータである。

regex_iterator オブジェクトを構築した時、および、operator++ を呼び出す毎に、当該イテレータは regex_search を呼び出して検索し、マッチ結果オブジェクト（match_results）を内部に保存する（ただし、operator++ も参照）。 イテレータが終端まで来たとき（つまり、regex_search が false を返したとき）、当該イテレータはシーケンスの終端を示す特別な値となる。 この、シーケンスの終端を示す特別な値は、regex_iterator オブジェクトをデフォルトコンストラクタにより構築した場合にも生成されるため、この値と比較することによってシーケンスの終端であるか否か（つまり、マッチしなかったか否か）が判別できる。

シーケンス終端のイテレータに対する operator* 演算子適用は未定義動作を引き起こす。その他のイテレータに対する operator* 演算子適用の結果は const match_results<BidirectionalIterator>& である。
同様に、シーケンス終端のイテレータに対する operator-> 演算子適用は未定義動作を引き起こす。その他のイテレータに対する operator-> 演算子適用の結果は const match_results<BidirectionalIterator>* である。

なお、本サイトの regex_iterator の各説明では、規格にならって以下のプライベートなメンバ変数が存在する前提で記載している。

• 検索対象文字列の開始位置を示すイテレータ begin（BidirectionalIterator 型）
• 検索対象文字列の終了位置を示すイテレータ end（BidirectionalIterator 型）
• 検索する正規表現へのポインタ pregex（const basic_regex<charT, traits>* 型。正規表現のコピーではないことに注意）
• 検索フラグ flags（regex_constants::match_flag_type 型）
• 最後の検索のマッチ結果オブジェクト match（match_results<BidirectionalIterator 型）

しかし、規格上これらのメンバ変数は説明のためだけに導入されているため、実際の各実装でこれらのメンバ変数が存在するとは限らない事に注意すること。

regex_iterator は iterator_category を forward_iterator_tag に定義しているため、基本的には前方向イテレータであると考えられるが、実際には前方向イテレータの要件のうち以下の要件を満たしていない。

• 2 つの間接参照可能な regex_iterator オブジェクト a と b がある時、a == b の場合でも、++a == ++b とは限らない。
• 2 つの間接参照可能な regex_iterator オブジェクト a と b がある時、a == b の場合でも、*a と *b が同じオブジェクトとは限らない。

メンバ関数

構築・破棄

比較

間接

インクリメント

メンバ型

説明用プライベートメンバ変数

非メンバ型

例

#include <iostream>
#include <iterator>
#include <regex>
#include <string>

int main()
{
  std::string s("a01da123456da999d");
  std::regex re("\\d+");

  for (std::sregex_iterator it(std::begin(s), std::end(s), re), end; it != end; ++it) {
    auto&& m = *it;
    std::cout << "position = " << m.position() << ", length = " << m.length() << ", str = '" << m.str() << '\'' << std::endl;
  }
}

出力

position = 1, length = 2, str = '01'
position = 5, length = 6, str = '123456'
position = 13, length = 3, str = '999'

バージョン

言語

• C++11

処理系

• Clang: 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅, 3.4 ✅, 3.5 ✅, 3.6 ✅
• GCC: 4.9.0 ✅, 4.9.1 ✅, 5.0.0 ✅
• Visual C++: ?

ただし、Clang と GCC の 4.9.1 までのバージョンには、長さ 0 の文字列にマッチした時の挙動に問題があるため、注意が必要。 （特に、Clang は長さ 0 の文字列にマッチするとそこから先に進まなくなってしまう）