Namespaces
Variants

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

From cppreference.net
C++
Ranges library
Range adaptors
std::ranges::subrange
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 le begin_ est incrémenté (ou décrémenté si n est négatif). L'opération d'incrémentation (ou de décrémentation) est effectuée par advance() .

1) Renvoie 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 ) ; .

Table des matières

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)