CKTIS / C++
std::vector::front — accedere al primo elemento
`front()` accede al primo elemento di un vettore in tempo costante. Se il vettore potrebbe essere vuoto, controlla prima `empty()`.
Versione: ISO C++23; implementation support may vary
Sintassi
// Member declarations in std::vector<T, Allocator>, declared in <vector>
constexpr reference front();
constexpr const_reference front() const;std::vector::front è una funzione membro dichiarata in <vector> che accede al primo elemento senza rimuoverlo. Per un vettore non vuoto v, v.front() equivale a *v.begin() e accede allo stesso elemento di v[0]. L’accesso richiede tempo O(1). Entrambi gli overload sono constexpr da C++20.
In C++23, chiamare front() su un vettore vuoto causa un comportamento indefinito. Non fare affidamento su un’eccezione o su un messaggio diagnostico. Se il vettore potrebbe essere vuoto, chiama front() solo quando !v.empty() è vero. Se vuoi che l’accesso a un elemento mancante generi un’eccezione, usa v.at(0), che lancia std::out_of_range quando il vettore è vuoto.
Per std::vector<T> con T diverso da bool, l’overload non const restituisce T&, quindi un’assegnazione a v.front() modifica l’elemento. L’overload const restituisce const T&, che non consente di modificare l’elemento tramite quel riferimento. Per std::vector<bool>, l’overload non const restituisce per valore un oggetto proxy che consente di modificare il bit, mentre l’overload const restituisce un valore bool.
Conservare un riferimento non prolunga la vita dell’elemento. Non usarlo dopo che l’elemento è stato rimosso, il vettore distrutto o la sua memoria riallocata, ad esempio quando push_back() deve aumentare la capacità. Non conservare nemmeno un riferimento restituito da front() su un vettore temporaneo oltre l’espressione completa che ha creato quel vettore.
Esempi
#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>{});
}
Risultato
42 empty
L’assegnazione tramite `first` cambia il primo elemento in `42`. `print_first` lo legge tramite l’overload `const` e stampa `empty` per un vettore vuoto senza chiamare `front()`.
Lezioni correlate
- C++ · Lezione 28 · Avanzato · Versione: 3