CKTIS / C++
std::next — een opgeschoven kopie van een iterator
std::next uit <iterator> retourneert een kopie van een iterator die n posities is opgeschoven, standaard één positie. De functie werkt ook met iterators zonder operator +. Ze controleert geen bereikgrenzen; een negatieve verplaatsing vereist een bidirectionele iterator.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iterator>
template<class InputIterator>
constexpr InputIterator next(
InputIterator x,
typename std::iterator_traits<InputIterator>::difference_type n = 1
);std::next(x, n) neemt een iterator per waarde aan, voert het equivalent van std::advance(x, n) uit en retourneert het resultaat. Als n wordt weggelaten, is de waarde 1. Anders dan std::advance wijst de functie de nieuwe positie niet toe aan de opgegeven iteratorvariabele.
De functie werkt met invoeriterators die voldoen aan de eisen van Cpp17InputIterator. Een negatieve n vereist een bidirectionele iterator. De kosten zijn O(1) voor iterators met willekeurige toegang en O(|n|) in andere gevallen. Een iterator van std::list ondersteunt bijvoorbeeld geen +, maar kan met std::next worden opgeschoven.
De functie ontvangt geen bereikgrens en controleert die ook niet. Verplaats de iterator niet voorbij de toegestane posities. Het resultaat mag gelijk zijn aan end(), maar mag dan niet worden gedereferentieerd. Het kopiëren van een invoeriterator voor een eenmalige doorgang garandeert geen onafhankelijke lezing: het opschuiven van de kopie kan gedeelde invoer verbruiken en eerdere kopieën ongeldig maken.
Verwar std::next niet met std::ranges::next: die laatste biedt ook overloads met een sentinel, waaronder std::ranges::next(x, n, bound), die het opschuiven bij de grens stopt. Het onderstaande voorbeeld gebruikt bidirectionele iterators: first blijft op 10, third wijst naar 30 en één stap terug vanaf end() geeft 40.
Voorbeelden
#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';
}
Resultaat
10 30 40
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.