Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje