operator- (std::counted_iterator)

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

Поведение не определено, если x и y не указывают на элементы одной и той же последовательности. То есть должно существовать некоторое n такое, что std:: next ( x. base ( ) , x. count ( ) + n ) и std:: next ( y. base ( ) , y. count ( ) + n ) ссылаются на один и тот же элемент.

Этот шаблон функции не виден для обычного unqualified или qualified lookup , и может быть найден только с помощью argument-dependent lookup , когда std::counted_iterator<I> является ассоциированным классом аргументов.

Параметры

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

y. count ( ) - x. count ( )

Примечания

Поскольку длина отсчитывается вниз, а не вверх, порядок аргументов operator - в базовом выражении обратный, т.е. y является lhs , а x является rhs .

Пример

#include <initializer_list>
#include <iterator>
int main()
{
    static constexpr auto v = {1, 2, 3, 4, 5, 6};
    constexpr std::counted_iterator<std::initializer_list<int>::iterator>
        it1{v.begin(), 5},
        it2{it1 + 3},
        it3{v.begin(), 2};
    static_assert(it1 - it2 == -3);
    static_assert(it2 - it1 == +3);
//  static_assert(it1 - it3 == -3); // UB: операнды operator- не ссылаются на
                                    // элементы одной последовательности
}

Смотрите также