operator- (std::counted_iterator)

Calcula la distancia entre dos adaptadores de iterador.

El comportamiento es indefinido si x y y no apuntan a elementos de la misma secuencia. Es decir, debe existir algún n tal que std:: next ( x. base ( ) , x. count ( ) + n ) y std:: next ( y. base ( ) , y. count ( ) + n ) se refieran al mismo elemento.

Esta plantilla de función no es visible para la búsqueda unqualified o qualified ordinaria, y solo puede ser encontrada mediante argument-dependent lookup cuando std::counted_iterator<I> es una clase asociada de los argumentos.

Parámetros

Valor de retorno

y. count ( ) - x. count ( )

Notas

Dado que la longitud decrece, no aumenta, el orden de los argumentos de operator - en la expresión subyacente está invertido, es decir, y es lhs y x es rhs .

Ejemplo

#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: los operandos de operator- no se refieren a
                                    // elementos de la misma secuencia
}

Véase también