оператор-(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 );

Вычисляет расстояние между двумя адаптерами итераторов. Два стоп-значения считаются равными.

Пусть var обозначает базовое std::variant член-объект в std::common_iterator, поведение не определено, если x или y недействительны, т. е. x.var.valueless_by_exception() || y.var.valueless_by_exception() является true.

Этот шаблон функции не виден для обычного неквалифицированного или квалифицированного поиска и может быть найден только при поиске зависимых от аргументов, когда std::common_iterator<I> является связанным классом аргументов.

Параметры

Возвращаемое значение

• ​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++.

См. также