CKTIS / C++
std::vector::empty — vérifier si un vecteur est vide
Utilisez `v.empty()` pour savoir en temps constant si un vecteur ne contient aucun élément. La capacité réservée ne change pas le résultat.
Version : ISO C++23; implementation support may vary
Syntaxe
constexpr bool empty() const noexcept;Incluez <vector> et appelez v.empty(). std::vector::empty est une fonction membre sans argument : elle renvoie true si le vecteur ne contient aucun élément et false sinon. Elle s’exécute en O(1), ne modifie pas le vecteur, peut être appelée sur un vecteur const et ne lève pas d’exception (noexcept depuis C++11). Elle est constexpr depuis C++20 et peut servir dans une évaluation constante si l’expression entière en remplit les conditions.
Le résultat est équivalent à v.size() == 0 et à v.begin() == v.end(). Préférez v.empty() pour une réponse par oui ou non et v.size() pour obtenir le nombre d’éléments. std::empty(v) (depuis C++17, <iterator>) est une fonction non membre distincte qui appelle v.empty() pour un vecteur.
Un appel réussi à v.reserve(n) garantit une capacité d’au moins n sans créer d’éléments : un vecteur vide le reste. push_back ou emplace_back ajoute un élément ; clear() détruit tous les éléments sans modifier la capacité. Les mêmes règles s’appliquent à std::pmr::vector, qui utilise un autre allocateur.
Vérifiez !v.empty() avant d’appeler v.back() ou v.front() : sur un vecteur vide, ces appels ont un comportement indéfini en C++23. Ne déréférencez jamais v.end() ; dans un vecteur vide, v.begin() lui est égal. Un vecteur non vide ne rend pas tout indice i valide : pour v[i], la valeur de i après conversion vers le type size_type du vecteur doit être inférieure à v.size(). Une fonction de calcul de médiane peut rejeter explicitement une entrée vide en levant std::invalid_argument de <stdexcept> ; empty() ne lève pas cette exception.
Exemples
#include <iostream>
#include <vector>
int main() {
std::vector<int> v;
v.reserve(8);
std::cout << std::boolalpha;
std::cout << "reserve: " << v.empty() << '\n';
v.push_back(42);
if (!v.empty()) {
std::cout << "back: " << v.back() << '\n';
}
v.clear();
std::cout << "clear: " << v.empty() << '\n';
}Résultat
reserve: true back: 42 clear: true
`reserve(8)` laisse le vecteur vide. Après l’insertion de `42`, le test autorise l’appel à `back()` ; après `clear()`, `empty()` renvoie de nouveau `true`.
Leçons associées
- C++ · Leçon 18 · Avancé · Version : 3
- C++ · Leçon 23 · Avancé · Version : 3
- C++ · Leçon 30 · Avancé · Version : 3
Sources
- WG21 N4950 — Working Draft, Standard for Programming Language C++ (C++23)
- Class template vector — [vector.overview]
- Container requirements — [container.reqmts]
- Vector capacity — [vector.capacity]
- Sequence containers — [sequence.reqmts]
- Header <vector> synopsis — [vector.syn]
- Range access — [iterator.range]
- Class invalid_argument — [invalid.argument]