CKTIS / C++
std::next — une copie avancée d’un itérateur
std::next, défini dans <iterator>, renvoie une copie d’un itérateur avancée de n positions, une par défaut. La fonction prend aussi en charge les itérateurs sans operator +. Elle ne vérifie pas les limites de la plage ; un décalage négatif exige un itérateur bidirectionnel.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <iterator>
template<class InputIterator>
constexpr InputIterator next(
InputIterator x,
typename std::iterator_traits<InputIterator>::difference_type n = 1
);std::next(x, n) prend un itérateur par valeur, effectue l’équivalent de std::advance(x, n) et renvoie le résultat. Si n est omis, sa valeur est 1. Contrairement à std::advance, la fonction n’affecte pas la nouvelle position à la variable itérateur fournie.
Elle fonctionne avec les itérateurs d’entrée qui satisfont aux exigences de Cpp17InputIterator. Un n négatif exige un itérateur bidirectionnel. Le coût est O(1) pour les itérateurs à accès aléatoire et O(|n|) dans les autres cas. Par exemple, un itérateur de std::list ne prend pas en charge +, mais std::next permet de le faire avancer.
La fonction ne reçoit aucune limite de plage et n’en vérifie aucune. Il ne faut pas déplacer l’itérateur au-delà des positions autorisées. Le résultat peut être égal à end(), mais il ne faut alors pas le déréférencer. Copier un itérateur d’entrée à parcours unique ne garantit pas une lecture indépendante : avancer la copie peut consommer une entrée partagée et invalider les copies précédentes.
Ne confondez pas std::next avec std::ranges::next : cette dernière propose aussi des surcharges avec sentinelle, notamment std::ranges::next(x, n, bound), qui arrête l’avancement à la limite. L’exemple ci-dessous utilise des itérateurs bidirectionnels : first reste sur 10, third pointe sur 30 et reculer depuis end() donne 40.
Exemples
#include <iostream>
#include <iterator>
#include <list>
int main() {
const std::list<int> values{10, 20, 30, 40};
auto first = values.begin();
auto third = std::next(first, 2);
auto last = std::next(values.end(), -1);
std::cout << *first << ' ' << *third << ' ' << *last << '\n';
}
Résultat
10 30 40
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.