Namespaces
Variants

operator== (std::common_iterator)

From ja.cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
template < class I2, std:: sentinel_for < I > S2 >

requires std:: sentinel_for < S, I2 >
friend constexpr bool operator == ( const common_iterator & x,

const std:: common_iterator < I2, S2 > & y ) ;
(1) (C++20以降)
template < class I2, std:: sentinel_for < I > S2 >

requires std:: sentinel_for < S, I2 > && std:: equality_comparable_with < I, I2 >
friend constexpr bool operator == ( const common_iterator & x,

const std:: common_iterator < I2, S2 > & y ) ;
(2) (C++20以降)

基となる std::variant メンバオブジェクト var が保持するイテレータおよび/またはセンチネルを比較します。比較不能な2つのイテレータまたは2つのセンチネルは等しいと見なされます。

x または y のいずれかが無効な状態、すなわち x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) が true に等しい場合、動作は未定義です。

i を x. var . index ( ) とし、 j を y. var . index ( ) とする。

1) もし i == j の場合(つまり x と y の両方がイテレータを保持しているか、両方が番兵を保持している場合)、 true を返し、それ以外の場合は std :: get < i > ( x. var ) == std :: get < j > ( y. var ) を返します。
2) もし i == 1 && j == 1 の場合(つまり x と y の両方がセンチネル値を保持している場合)、 true を返し、それ以外の場合は std :: get < i > ( x. var ) == std :: get < j > ( y. var ) を返す。

!= 演算子は synthesized され、 operator== から生成されます。

これらの関数テンプレートは通常の unqualified lookup または qualified lookup では可視化されず、引数がstd::common_iterator<I>を関連クラスとして持つ場合にのみ argument-dependent lookup によって発見されます。

目次

パラメータ

x, y - 比較用イテレータアダプタ

戻り値

true 基礎となるイテレータおよび/またはセンチネルが等しい場合。

例

#include <cassert>
#include <iterator>
int main()
{
    int a[]{0, 1, 2, 3};
    using CI = std::common_iterator<
                   std::counted_iterator<int*>,
                   std::default_sentinel_t
                   >;
    CI i1{std::counted_iterator{a + 0, 2}};
    CI i2{std::counted_iterator{a + 1, 2}};
    CI i3{std::counted_iterator{a + 0, 3}};
    CI i4{std::counted_iterator{a + 0, 0}};
    CI s1{std::default_sentinel};
    CI s2{std::default_sentinel};
    assert((i1 == i2) == true);
    assert((i1 == i3) == false);
    assert((i2 == i3) == false);
    assert((s1 == s2) == true);
    assert((i1 == s1) == false);
    assert((i4 == s1) == true);
}

不具合報告

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

DR Applied to Behavior as published Correct behavior
LWG 3574 C++20 variant は完全なconstexpr(P2231R1)であったが、 common_iterator はconstexprではなかった 同様にconstexpr化

関連項目

(C++20)
2つのイテレータアダプタ間の距離を計算する
(関数テンプレート)