op_deref.md

operator*

• regex[meta header]
• std[meta namespace]
• regex_token_iterator[meta class]
• function[meta id-type]
• cpp11[meta cpp]

const value_type& operator*() const;

概要

イテレータを間接参照する。

要件

シーケンスの終端を示すイテレータではない事。（シーケンス終端イテレータに対して呼び出した場合は未定義動作を引き起こす）

戻り値

*result（つまり、メンバ変数 result の参照先オブジェクト *result への const 参照）

備考

• value_type は regex_token_iterator のメンバ型で、sub_match<BidirectionalIterator> である。
• 戻り値の型は const への参照であるため、この参照を通した変更はできない。
• メンバ変数 result はあくまでも説明用のプライベートメンバ変数であるため、注意すること。

例

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

int main()
{
  const std::string s("enum E { enumerator1 = value1, enumerator2 = value2, enumerator3 = value3, };");
  const std::regex re(R"((\w+)\s*=\s*(\w+))");

  // 1 番目と 2 番目のサブマッチを順に繰り返す
  for (std::sregex_token_iterator it(std::begin(s), std::end(s), re, { 1, 2 }), end; it != end; ++it) {
    // 間接参照した結果を参照型のローカル変数 m に代入（m の型は const value_type&）
    auto&& m = *it;
    std::cout << "match range = (" << m.first - std::begin(s) << ", " << m.second - std::begin(s) << "), "
                 "str = '" << m.str() << '\'' << std::endl;
  }
}

• std::regex[link /reference/regex/basic_regex.md]
• m.str()[link /reference/regex/sub_match/str.md]

出力

match range = (9, 20), str = 'enumerator1'
match range = (23, 29), str = 'value1'
match range = (31, 42), str = 'enumerator2'
match range = (45, 51), str = 'value2'
match range = (53, 64), str = 'enumerator3'
match range = (67, 73), str = 'value3'

バージョン

言語

• C++11

処理系

• Clang: 3.0 [mark verified], 3.1 [mark verified], 3.2 [mark verified], 3.3 [mark verified], 3.4 [mark verified], 3.5 [mark verified], 3.6 [mark verified]
• GCC: 4.9.0 [mark verified], 4.9.1 [mark verified], 5.0.0 [mark verified]
• ICC: ??
• Visual C++: ??

関連項目

名前	説明	対応バージョン
operator->	メンバアクセス	C++11
(constructor)	コンストラクタ	C++11
operator++	インクリメント	C++11
operator==	等値比較	C++11