Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::vector::front — dostęp do pierwszego elementu

`front()` daje dostęp do pierwszego elementu wektora w czasie stałym. Jeśli wektor może być pusty, najpierw sprawdź `empty()`.

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

Składnia

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

std::vector::front to funkcja składowa z nagłówka <vector>, która daje dostęp do pierwszego elementu bez usuwania go. Dla niepustego wektora v wyrażenie v.front() jest równoważne *v.begin() i wskazuje ten sam element co v[0]. Dostęp ma złożoność O(1). Oba przeciążenia są constexpr od C++20.

W C++23 wywołanie front() na pustym wektorze powoduje niezdefiniowane zachowanie. Nie polegaj na wyjątku ani komunikacie diagnostycznym. Jeśli wektor może być pusty, wywołuj front() tylko wtedy, gdy !v.empty() jest prawdziwe. Jeśli brak elementu ma być zgłoszony wyjątkiem, użyj v.at(0), które dla pustego wektora zgłasza std::out_of_range.

Dla std::vector<T> z T innym niż bool przeciążenie dla wektora niebędącego const zwraca T&, więc przypisanie do v.front() zmienia element. Przeciążenie const zwraca const T& i nie pozwala zmienić elementu przez tę referencję. Dla std::vector<bool> przeciążenie bez const zwraca przez wartość obiekt pośredniczący, który pozwala zmienić bit, a przeciążenie const zwraca wartość bool.

Zachowana referencja nie przedłuża czasu życia elementu. Nie używaj jej po usunięciu elementu, zniszczeniu wektora ani realokacji jego pamięci, na przykład gdy push_back() wymaga zwiększenia pojemności. Nie zachowuj też referencji zwróconej przez front() obiektu tymczasowego po zakończeniu wyrażenia, w którym ten obiekt powstał.

Przykłady

#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>{});
}

Wynik

42
empty

Przypisanie przez `first` zmienia pierwszy element na `42`. Funkcja `print_first` odczytuje go przez przeciążenie `const`, a dla pustego wektora wypisuje `empty` bez wywoływania `front()`.

Powiązane lekcje

  • C++ · Lekcja 28 · Zaawansowany · Wersja: 3

Źródła