5. operator==

最終更新日時(UTC):
が更新

履歴 編集

function template
<iterator>

std::operator==

namespace std {
  template <class T, class CharT, class Traits, class Distance>
  bool operator==(const istream_iterator<T, CharT, Traits, Distance>& x,
                  const istream_iterator<T, CharT, Traits, Distance>& y); // (1) C++03

  template <class T,
           class charT = char,
           class traits = char_traits<charT>,
           class Distance = ptrdiff_t>
  class istream_iterator {
  public:
    friend bool operator==(const istream_iterator& i, default_sentinel_t); // (2) C++20
  };
}

概要

2つのistream_iteratorオブジェクトを等値比較する

戻り値

  • (1) : xとyがどちらも同じ有効な入力ストリームオブジェクトを指す場合、もしくはどちらも無効な入力ストリームオブジェクトを指す場合はtrueを返し、そうでなければfalseを返す
  • (2) : iが有効な入力ストリームオブジェクトを指していればtrue、そうでなければfalseを返す

備考

  • この演算子により、以下の演算子が自動導出される (C++20)：
    • operator==(default_sentinel_t, const istream_iterator&)
    • operator!=(const istream_iterator&, const istream_iterator&)
    • operator!=(const istream_iterator&, default_sentinel_t)
    • operator!=(default_sentinel_t, const istream_iterator&)

例

#include <iostream>
#include <iterator>
#include <sstream>

int main()
{
  std::stringstream ss;
  ss << 1;

  std::istream_iterator<int> it1(ss);
  std::istream_iterator<int> it2 = it1;
  std::istream_iterator<int> last;

  std::cout << std::boolalpha;

  std::cout << "it1 == it2 : " << (it1 == it2) << std::endl;
  std::cout << "it1 == last : " << (it1 == last) << std::endl;

  ++it1;

  // it1は入力ストリームから要素を読み取り終わっているので終端となる
  std::cout << "it1 == last : " << (it1 == last) << std::endl;
}

出力

it1 == it2 : true
it1 == last : false
it1 == last : true

参照