CKTIS / C++
std::vector::front — accéder au premier élément
`front()` accède au premier élément d’un vecteur en temps constant. Si le vecteur peut être vide, vérifiez d’abord `empty()`.
Version : 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 est une fonction membre déclarée dans <vector> qui accède au premier élément sans le retirer. Pour un vecteur non vide v, v.front() est équivalent à *v.begin() et accède au même élément que v[0]. L’accès prend un temps O(1). Les deux surcharges sont constexpr depuis C++20.
En C++23, appeler front() sur un vecteur vide entraîne un comportement indéfini. Ne comptez ni sur une exception ni sur un diagnostic. Si le vecteur peut être vide, n’appelez front() que si !v.empty() est vrai. Si vous voulez que l’accès à un élément absent lève une exception, utilisez v.at(0), qui lève std::out_of_range lorsque le vecteur est vide.
Pour std::vector<T> avec T différent de bool, la surcharge non const renvoie T& : une affectation à v.front() modifie donc l’élément. La surcharge const renvoie const T&, qui ne permet pas de modifier l’élément par cette référence. Pour std::vector<bool>, la surcharge non const renvoie par valeur un objet intermédiaire qui permet de modifier le bit, tandis que la surcharge const renvoie une valeur bool.
Conserver une référence ne prolonge pas la durée de vie de l’élément. Ne l’utilisez plus après la suppression de l’élément, la destruction du vecteur ou la réallocation de son stockage, par exemple si push_back() doit augmenter la capacité. Ne conservez pas non plus une référence renvoyée par front() sur un vecteur temporaire au-delà de l’expression complète qui a créé ce vecteur.
Exemples
#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>{});
}
Résultat
42 empty
L’affectation via `first` donne la valeur `42` au premier élément. `print_first` le lit via la surcharge `const` et affiche `empty` pour un vecteur vide sans appeler `front()`.
Leçons associées
- C++ · Leçon 28 · Avancé · Version : 3