Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::end: iterátor za koncom rozsahu

std::end vráti iterátor past-the-end kontajnera alebo ukazovateľ za vstavaným poľom.

Verzia: C++23

Syntax

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) z <iterator> volá c.end() a zachováva presný návratový typ, ale C++23 pri tomto preťažení nevyžaduje noexcept. Pre vstavané pole T array[N] vracia samostatné preťaženie array + N a je noexcept.

Vrátená pozícia je výlučná pravá hranica [begin, end) a nesmie sa dereferencovať. Pri prázdnom rozsahu sa rovná začiatku. Jej platnosť a zneplatnenie vychádzajú zo zdrojového objektu; iterátor, ktorý prežije kontajner, je visiaci.

Kvalifikované std::end(x) obsluhuje typy s členom end() a vstavané polia. V generickom kóde dovolí using std::end; end(x); navyše nájsť vlastné voľné preťaženie pomocou ADL. Nezamieňaj ho za std::ranges::end, ktoré má vlastné pravidlá rozsahov a sentinelov.

Príklady

#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';
}

Výsledok

3 9

std::end → 3 9

Zdroje