CKTIS / C++
std::prev — pomicanje iteratora unatrag
std::prev iz zaglavlja <iterator> vraća pomaknutu kopiju dvosmjernog iteratora bez promjene argumenta. Zadano ga pomiče jedan korak unatrag; negativan n znači pomicanje unaprijed. Pozivatelj mora osigurati da pomicanje ostane unutar valjanih granica i da izračun -n ne uzrokuje preljev.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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) vraća iterator iste vrste kao x, pomaknut za n koraka unatrag. Zadana vrijednost za n je 1; n == 0 ostavlja položaj nepromijenjenim, a negativan n pomiče unaprijed. Funkcija iz <iterator> radi na kopiji: ekvivalentna je zapisu std::advance(x, -n); return x;, pa ne mijenja predani iterator.
Ako je difference_type iteratora uski cjelobrojni tip s predznakom, unarni minus može uzrokovati promociju vrijednosti n u tip int. U tom slučaju std::advance može primiti rezultat tipa int čak i ako se on ne može prikazati u izvornom tipu difference_type. No ako je n najmanja vrijednost cjelobrojnog tipa s predznakom koji ne podliježe promociji (primjerice std::ptrdiff_t kad se ne promovira), izračun -n uzrokuje preljev cijelog broja s predznakom i time nedefinirano ponašanje, čak i ako bi namjeravani pomak ostao unutar valjanih granica.
Vrsta mora ispunjavati zahtjeve za dvosmjerne iteratore, čak i kada je n negativan. Iteratorima s nasumičnim pristupom potrebno je konstantno vrijeme; ostalim dvosmjernim iteratorima potrebno je vrijeme linearno u odnosu na broj koraka. Rezultat je iterator, a ne vrijednost elementa; element pročitajte pomoću * ako se rezultat može dereferencirati.
Funkcija ne provjerava granice. Nemojte se pomicati prije početka ni izvan valjanog raspona. std::prev(values.end()) pokazuje na posljednji element samo u nepraznom spremniku s odgovarajućim iteratorom; taj je korak unatrag nevaljan za prazan spremnik. Sam end() ne može se dereferencirati.
Nemojte brkati std::prev s std::ranges::prev: potonji ima i preopterećenje koje prima granicu bound, što std::prev ne nudi. Primjer upotrebljava std::list<int> za prikaz pomicanja unatrag, pomicanja unaprijed s negativnim n i očuvanja izvornog iteratora.
Primjeri
#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';
}
Rezultat
40 30 40 true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.