std::ranges::subrange<I,S,K>::next
Depuis fr.cppreference.net
constexpr subrange next( std::iter_difference_t<I> n = 1 ) const&
requires std::forward_iterator<I>;
|
(1) | (depuis C++20) |
constexpr subrange next( std::iter_difference_t<I> n = 1 ) &&;
|
(2) | (depuis C++20) |
Retourne un subrange dont l'begin_ est incrémenté (ou décrémenté si n est négatif). L'opération d'incrémentation (ou de décrémentation) réelle est effectuée par advance().
1) Retourne une copie de
*this. Équivalent à :
auto tmp = *this;tmp.advance(n);return tmp;.2) Retourne un
subrange déplacé depuis *this. Équivalent à :
advance(n);return std::move(*this);.Paramètre
| n | - | nombre d'incrémentations maximales de l'itérateur |
Valeur de retour
Comme décrit ci-dessus.
Notes
La différence entre cette fonction et
advance()
est que cette dernière effectue l'incrément (ou le décrément) en place.
Exemple
Exécuter ce code
#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)); }
Sortie :
1) sub: [3, 4, 5] 2) sub: [4, 5] 3) sub: [5]
Voir aussi
obtient une copie du
subrange
avec son itérateur décrémenté d'une distance donnée
(fonction membre publique) |
|
|
avance l'itérateur d'une distance donnée
(fonction membre publique) |
|
|
(C++11)
|
incrémente un itérateur
(modèle de fonction) |
|
(C++20)
|
incrémente un itérateur d'une distance donnée ou jusqu'à une limite
(objet fonction algorithme) |