CKTIS / C++
std::next — posunutá kopie iterátoru
std::next z hlavičky <iterator> vrací kopii iterátoru posunutou o n pozic, ve výchozím nastavení o jednu. Podporuje také iterátory bez operator +. Nekontroluje hranice rozsahu; záporný posun vyžaduje obousměrný iterátor.
Verze: 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) přijímá iterátor hodnotou, provede ekvivalent std::advance(x, n) a vrátí výsledek. Pokud n vynecháte, použije se hodnota 1. Na rozdíl od std::advance nepřiřadí novou pozici do předané proměnné iterátoru.
Funguje se vstupními iterátory, které splňují požadavky Cpp17InputIterator. Záporné n vyžaduje obousměrný iterátor. Složitost je O(1) pro iterátory s náhodným přístupem a O(|n|) v ostatních případech. Například iterátor std::list nepodporuje +, ale lze jej posouvat pomocí std::next.
Funkce nedostává hranici rozsahu a ani ji nekontroluje. Iterátor se nesmí posunout mimo povolené pozice. Výsledek může být roven end(), ale v takovém případě se nesmí dereferencovat. Kopírování vstupního iterátoru pro průchod jedním směrem nezaručuje nezávislé čtení: posouvání kopie může spotřebovat sdílený vstup a zneplatnit dřívější kopie.
Nezaměňujte std::next za std::ranges::next: druhá funkce nabízí také přetížení se sentinelovou hodnotou, například std::ranges::next(x, n, bound), které zastaví posouvání na hranici. Následující příklad používá obousměrné iterátory: first zůstává na 10, third ukazuje na 30 a posun zpět od end() dá 40.
Příklady
#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';
}
Výsledek
10 30 40
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.