Namespaces
Variants

operator- (std::common_iterator)

From cppreference.net
C++
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)
std::common_iterator
template < std:: sized_sentinel_for < I > I2, std:: sized_sentinel_for < I > S2 >

requires std:: sized_sentinel_for < S, I2 >
friend constexpr std:: iter_difference_t < I2 >

operator - ( const common_iterator & x, const std:: common_iterator < I2, S2 > & y ) ;
(C++20 이후)

두 반복자 어댑터 간의 거리를 계산합니다. 두 센티널은 동일한 것으로 간주됩니다.

var 이 std::variant 의 기반 멤버 객체를 나타낸다고 할 때, std::common_iterator 에서 x 또는 y 가 유효하지 않은 경우, 즉 x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) 가 true 인 경우의 동작은 정의되지 않습니다.

이 함수 템플릿은 일반적인 unqualified 또는 qualified lookup 으로는 보이지 않으며, std::common_iterator<I>가 인자들의 연관 클래스일 때에만 argument-dependent lookup 에 의해 발견될 수 있습니다.

목차

매개변수

x, y - 차이를 계산하기 위한 반복자 어댑터

반환값

  • ​ 0 ​ 만약 x. var 가 S 객체를 보유하고 y. var 가 S2 객체를 보유하는 경우, 즉 둘 다 센티널을 보유하는 경우.
  • 그렇지 않은 경우, alt_x - alt_y , 여기서 alt_x 와 alt_y 는 각각 x. var 와 y. var 이 보유한 대안입니다 (두 개의 반복자 또는 하나의 반복자와 하나의 센티널).

예제

이 코드 실행 
#include <algorithm>
#include <iostream>
#include <iterator>
int main()
{
    int a[]{0, 1, 2, 3, 4, 5};
    using CI = std::common_iterator<
                   std::counted_iterator<int*>,
                   std::default_sentinel_t
                   >;
    CI i1{std::counted_iterator{a + 1, 2}};
    CI i2{std::counted_iterator{a, 3}};
    CI s1{std::default_sentinel};
    CI s2{std::default_sentinel};
    std::cout << (s2 - s1) << ' '
              << (i2 - i1) << ' '
              << (i1 - s1) << '\n';
}

출력: 

0 -1 -2

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

DR 적용 대상 게시된 동작 올바른 동작
LWG 3574 C++20 variant 는 완전한 constexpr이었지만(P2231R1) common_iterator 는 그렇지 않았음 또한 constexpr로 만듦

참고 항목

common_iterator 를 전진시킵니다
(public member function)