std::ranges::subrange<I,S,K>::next
De es.cppreference.net
constexpr subrange next( std::iter_difference_t<I> n = 1 ) const&
requires std::forward_iterator<I>;
|
(1) | (desde C++20) |
constexpr subrange next( std::iter_difference_t<I> n = 1 ) &&;
|
(2) | (desde C++20) |
Devuelve un subrange cuyo begin_ se incrementa (o decrementa si n es negativo). La operación de incremento (o decremento) real se realiza mediante 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);.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) |