CKTIS / C++
std::vector::front — Zugriff auf das erste Element
`front()` greift in konstanter Zeit auf das erste Element eines Vektors zu. Wenn der Vektor leer sein könnte, prüfe zuerst `empty()`.
Version: ISO C++23; implementation support may vary
Syntax
// Member declarations in std::vector<T, Allocator>, declared in <vector>
constexpr reference front();
constexpr const_reference front() const;std::vector::front ist eine in <vector> deklarierte Memberfunktion, die auf das erste Element zugreift, ohne es zu entfernen. Für einen nicht leeren Vektor v ist v.front() gleichbedeutend mit *v.begin() und greift auf dasselbe Element zu wie v[0]. Der Zugriff dauert O(1). Beide Überladungen sind seit C++20 constexpr.
In C++23 führt ein Aufruf von front() für einen leeren Vektor zu undefiniertem Verhalten. Verlass dich weder auf eine Ausnahme noch auf eine Diagnose. Wenn der Vektor leer sein könnte, rufe front() nur auf, wenn !v.empty() wahr ist. Soll der Zugriff auf ein fehlendes Element stattdessen eine Ausnahme auslösen, verwende v.at(0): Bei einem leeren Vektor wird std::out_of_range ausgelöst.
Für std::vector<T> mit T ungleich bool gibt die Nicht-const-Überladung T& zurück. Eine Zuweisung an v.front() ändert daher das Element. Die const-Überladung gibt const T& zurück; über diese Referenz lässt sich das Element nicht ändern. Bei std::vector<bool> gibt die Nicht-const-Überladung ein Proxy-Objekt als Wert zurück, über das sich das Bit ändern lässt. Die const-Überladung gibt einen bool-Wert zurück.
Eine gespeicherte Referenz verlängert die Lebensdauer des Elements nicht. Verwende sie nicht mehr, wenn das Element entfernt, der Vektor zerstört oder sein Speicher neu zugeteilt wurde, etwa wenn push_back() die Kapazität erhöhen muss. Behalte eine von front() für einen temporären Vektor gelieferte Referenz nicht über den vollständigen Ausdruck hinaus, in dem der Vektor erzeugt wurde.
Beispiele
#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>{});
}
Ergebnis
42 empty
Die Zuweisung über `first` ändert das erste Element auf `42`. `print_first` liest es über die `const`-Überladung und gibt bei einem leeren Vektor `empty` aus, ohne `front()` aufzurufen.
Zugehörige Lektionen
- C++ · Lektion 28 · Fortgeschritten · Version: 3