Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::end: iterator iza kraja raspona

std::end vraća iterator past-the-end spremnika ili pokazivač iza ugrađenog polja.

Verzija: C++23

Sintaksa

template<class C>
constexpr auto end(C& c) -> decltype(c.end());

template<class T, std::size_t N>
constexpr T* end(T (&array)[N]) noexcept;

std::end(c) iz <iterator> poziva c.end() i čuva točan povratni tip, ali C++23 za to preopterećenje ne zahtijeva noexcept. Za ugrađeno polje T array[N] zasebno preopterećenje vraća array + N i jest noexcept.

Vraćeni položaj isključiva je desna granica [begin, end) i ne smije se dereferencirati. Za prazan raspon jednak je početku. Valjanost i poništavanje ovise o izvornom objektu; iterator koji nadživi spremnik postaje viseći.

Kvalificirani std::end(x) podržava tipove s članom end() i ugrađena polja. U generičkom kodu using std::end; end(x); omogućuje da ADL pronađe i vlastito slobodno preopterećenje. Ne miješaj ga sa std::ranges::end, koji ima posebna pravila raspona i sentinela.

Primjeri

#include <iostream>
#include <iterator>

int main() {
    int values[]{4, 7, 9};
    const auto last = std::end(values);
    std::cout << (last - std::begin(values)) << ' ' << *(last - 1) << '\n';
}

Rezultat

3 9

std::end → 3 9

Izvori