Namespaces
Variants

std::ranges::subrange<I,S,K>:: next

From cppreference.net
C++
Ranges library
Range adaptors
std::ranges::subrange
constexpr subrange siguiente ( std:: iter_difference_t < I > n = 1 ) const &
requiere std:: forward_iterator < I > ;
(1) (desde C++20)
constexpr subrange siguiente ( std:: iter_difference_t < I > n = 1 ) && ;
(2) (desde C++20)

Retorna un subrange cuyo begin_ está incrementado (o decrementado si n es negativo). La operación real de incremento (o decremento) es realizada por advance() .

1) Devuelve una copia de * this .
Equivalente a: auto tmp = * this ;
tmp. advance ( n ) ;
return tmp ; .
2) Devuelve un subrange movido desde * this .
Equivalente a: advance ( n ) ;
return std :: move ( * this ) ; .

Contenidos

Parámetro

n - número de incrementos máximos del iterador

Valor de retorno

Como se describió anteriormente.

Notas

La diferencia entre esta función y advance() es que esta última realiza el incremento (o decremento) en el lugar.

Ejemplo

Ejecutar este código 
#include <array>
#include <iterator>
#include <print>
#include <ranges>
int main()
{
    std::array arr{1, 2, 3, 4, 5, 6, 7};
    std::ranges::subrange sub{std::next(arr.begin(), 2), std::prev(arr.end(), 2)};
    std::println("1) sub: {}", sub);
    std::println("2) sub: {}", sub.next());
    std::println("3) sub: {}", sub.next(2));
}

Salida: 

1) sub: [3, 4, 5]
2) sub: [4, 5]
3) sub: [5]

Véase también

obtiene una copia del subrange con su iterador decrementado por una distancia dada
(función miembro pública)
avanza el iterador por una distancia dada
(función miembro pública)
(C++11)
incrementa un iterador
(plantilla de función)
(C++20)
incrementa un iterador por una distancia dada o hasta un límite
(objeto función de algoritmo)