Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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