operator- (std::common_iterator)

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

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

Этот шаблон функции не видим для обычного unqualified или qualified lookup , и может быть найден только с помощью argument-dependent lookup , когда 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++.

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