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

CKTIS / C++

std::prev — posunutí iterátoru zpět

std::prev z hlavičky <iterator> vrací posunutou kopii obousměrného iterátoru, aniž by změnila argument. Ve výchozím nastavení jej posune o jeden krok zpět; záporné n znamená pohyb vpřed. Volající musí zajistit, aby posun zůstal v platných mezích a aby při vyhodnocení -n nedošlo k přetečení.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <iterator>

template<class BidirectionalIterator>
constexpr BidirectionalIterator prev(
    BidirectionalIterator x,
    typename std::iterator_traits<BidirectionalIterator>::difference_type n = 1);

std::prev(x)
std::prev(x, n)

std::prev(x, n) vrací iterátor stejného typu jako x, posunutý o n kroků zpět. Výchozí hodnota n je 1; n == 0 ponechá pozici beze změny a záporné n posouvá vpřed. Funkce z <iterator> pracuje s kopií: odpovídá zápisu std::advance(x, -n); return x;, takže předaný iterátor nemění.

Je-li difference_type iterátoru úzký celočíselný typ se znaménkem, může unární minus způsobit celočíselnou povýšení hodnoty n na typ int. V takovém případě může std::advance dostat výsledek typu int, i když jej nelze reprezentovat v původním typu difference_type. Je-li však n nejmenší hodnotou celočíselného typu se znaménkem, který se nepovyšuje (například std::ptrdiff_t, pokud u něj k povýšení nedochází), vyhodnocení -n způsobí přetečení celého čísla se znaménkem, a tím nedefinované chování, i kdyby zamýšlený posun zůstal v platných mezích.

Typ musí splňovat požadavky na obousměrné iterátory, i když je n záporné. Iterátory s náhodným přístupem pracují v konstantním čase; ostatní obousměrné iterátory vyžadují čas lineární vzhledem k počtu kroků. Výsledkem je iterátor, nikoli hodnota prvku; prvek lze přečíst pomocí *, pokud lze výsledek dereferencovat.

Funkce nekontroluje hranice. Neposouvejte se před začátek ani mimo platný rozsah. std::prev(values.end()) ukazuje na poslední prvek pouze u neprázdného kontejneru s vhodným iterátorem; tento krok zpět je u prázdného kontejneru neplatný. Samotný end() nelze dereferencovat.

Nezaměňujte std::prev za std::ranges::prev: druhá funkce má také přetížení přijímající hranici bound, které std::prev nenabízí. Příklad používá std::list<int> a ukazuje pohyb zpět, pohyb vpřed se záporným n i zachování původního iterátoru.

Příklady

#include <iostream>
#include <iterator>
#include <list>

int main() {
    const std::list<int> values{10, 20, 30, 40};
    const auto finish = values.end();
    const auto last = std::prev(finish);
    const auto earlier = std::prev(finish, 2);
    const auto forward = std::prev(earlier, -1);

    std::cout << *last << ' ' << *earlier << ' ' << *forward << '\n';
    std::cout << std::boolalpha << (finish == values.end()) << '\n';
}

Výsledek

40 30 40
true

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