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

CKTIS / C++

std::vector::front — přístup k prvnímu prvku

`front()` zpřístupňuje první prvek vektoru v konstantním čase. Pokud může být vektor prázdný, nejprve to ověř pomocí `empty()`.

Verze: ISO C++23; implementation support may vary

Syntaxe

// Member declarations in std::vector<T, Allocator>, declared in <vector>
constexpr reference front();
constexpr const_reference front() const;

std::vector::front je členská funkce deklarovaná v <vector>, která zpřístupní první prvek, aniž ho odebere. Pro neprázdný vektor v je v.front() ekvivalentní výrazu *v.begin() a zpřístupňuje stejný prvek jako v[0]. Přístup trvá O(1). Obě přetížení jsou od C++20 constexpr.

V C++23 má volání front() na prázdném vektoru nedefinované chování. Nespoléhej na výjimku ani na diagnostickou zprávu. Pokud může být vektor prázdný, volej front() pouze tehdy, když platí !v.empty(). Pokud má přístup k chybějícímu prvku vyvolat výjimku, použij v.at(0), které u prázdného vektoru vyvolá std::out_of_range.

Pro std::vector<T>, kde T není bool, vrací přetížení bez const typ T&, takže přiřazením do v.front() změníš prvek. Přetížení const vrací const T& a přes tuto referenci prvek nezměníš. U std::vector<bool> vrací přetížení bez const hodnotou zástupný objekt, přes který lze bit změnit, zatímco přetížení const vrací hodnotu typu bool.

Uchováním reference neprodloužíš životnost prvku. Nepoužívej ji po odebrání prvku, zániku vektoru ani realokaci jeho úložiště, například když push_back() musí zvýšit kapacitu. Referenci vrácenou funkcí front() na dočasném vektoru neuchovávej po skončení úplného výrazu, ve kterém tento vektor vznikl.

Příklady

#include <iostream>
#include <vector>

void print_first(const std::vector<int>& values)
{
    if (values.empty()) {
        std::cout << "empty\n";
        return;
    }
    std::cout << values.front() << '\n';
}

int main()
{
    std::vector<int> values{7, 9};
    int& first = values.front();
    first = 42;

    print_first(values);
    print_first(std::vector<int>{});
}

Výsledek

42
empty

Přiřazení přes `first` změní první prvek na `42`. Funkce `print_first` ho přečte přes přetížení `const` a u prázdného vektoru vypíše `empty`, aniž zavolá `front()`.

Související lekce

  • C++ · Lekce 28 · Pokročilá · Verze: 3

Zdroje