op_equal.md

operator==

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

namespace std {
  template <class BidirectinalIterator, class Allocator>
  bool operator==(const match_results<BidirectionalIterator, Allocator>& m1,
                  const match_results<BidirectionalIterator, Allocator>& m2);
}

概要

match_results オブジェクトを等値比較する。

戻り値

• どちらも ready() == false である場合、true を返す。
• いずれかが ready() == true で、もう一方が ready() == false である場合、false を返す。
• どちらも ready() == true である場合、以下のいずれかの条件を満たす場合に限り true を返す。
  • m1.empty() && m2.empty() である。
  • !m1.empty() && !m2.empty()、かつ、以下の条件をすべて満たす。
    • m1.prefix() == m2.prefix()
    • m1.size() == m2.size() && equal(m1.begin(), m1.end(), m2.begin()
    • m1.suffix() == m2.suffix()

備考

本関数では、基本的に文字列としての比較しかしていないため、実際には等しくない場合でも等しいと判断される場合がある。

例

#include <iostream>
#include <regex>

int main()
{
  const char s[] = "abc 012 def";

  const std::regex re1(R"((\w+)\s+(\d+)\s+(\w+))");
  std::cmatch m1;
  std::regex_search(s, m1, re1);
  for (auto&& sub : m1) {
    std::cout << sub << std::endl;
  }
  std::cout << std::endl;

  const std::regex re2(R"((\w*) (\w*) (\w*))");
  std::cmatch m2;
  std::regex_search(s, m2, re2);
  for (auto&& sub : m2) {
    std::cout << sub << std::endl;
  }
  std::cout << std::endl;

  std::cout << std::boolalpha << (m1 == m2) << std::endl;
}

• std::regex[link ../basic_regex.md]
• std::regex_search[link ../regex_search.md]
• std::cmatch[link ../match_results.md]

出力

abc 012 def
abc
012
def

abc 012 def
abc
012
def

true

バージョン

言語

• 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++: ??