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

CKTIS / C++

std::vector::clear — supprimer tous les éléments sans réduire la capacité

`std::vector::clear` détruit tous les éléments et ramène la taille du vecteur à zéro, tout en conservant sa capacité pour de futures insertions.

Version : ISO C++23; implementation support may vary

Syntaxe

#include <vector>

// Member declaration in std::vector<T, Allocator> (C++23):
constexpr void clear() noexcept;

// Call on a non-const vector v:
v.clear();

std::vector::clear est une fonction membre de <vector> : appelez v.clear() sur un vecteur non const. Elle ne prend aucun argument et ne renvoie aucune valeur (void). L’appel met fin à la durée de vie de tous les éléments. Ensuite, v.size() == 0 et v.empty() vaut vrai, même si le vecteur était déjà vide. La complexité est linéaire en fonction du nombre d’éléments avant l’appel. La fonction est noexcept depuis C++11 et constexpr depuis C++20.

La capacité (v.capacity()) reste inchangée. Les anciens éléments ne restent pas pour autant en vie : les pointeurs, références et itérateurs qui les désignent sont invalidés. Ne réutilisez pas non plus un itérateur end() conservé avant l’appel ; récupérez de nouveaux itérateurs avec begin() et end() au besoin.

Utilisez clear() pour remplacer les anciens résultats plutôt que d’en ajouter à la suite. Si vous copiez le début d’une séquence, assurez-vous que la source reste accessible après avoir vidé la destination. clear() ne réalise pas d’effacement sécurisé de la mémoire ; shrink_to_fit() est une demande distincte, non contraignante, de réduction de la capacité.

Exemples

#include <algorithm>
#include <iostream>
#include <string>
#include <vector>

int main() {
    const std::vector<std::string> ranked{"Ada", "Lin", "Mina"};
    std::vector<std::string> names{"Old A", "Old B", "Old C"};
    constexpr std::vector<std::string>::size_type k = 2;
    const auto count = std::min(k, ranked.size());
    const auto old_capacity = names.capacity();

    names.clear();
    std::cout << "size after clear: " << names.size() << '\n';
    std::cout << "capacity unchanged: " << std::boolalpha
              << (names.capacity() == old_capacity) << '\n';

    for (decltype(names)::size_type i = 0; i < count; ++i) {
        names.push_back(ranked[i]);
    }

    std::cout << "replacement names:\n";
    for (const auto& name : names) {
        std::cout << name << '\n';
    }
}

Résultat

size after clear: 0
capacity unchanged: true
replacement names:
Ada
Lin

Le programme borne `k` par la taille du vecteur source distinct, vide `names`, puis y ajoute les premiers éléments sélectionnés. Il compare la capacité avant et après le vidage sans supposer de valeur numérique précise.

Leçons associées

  • C++ · Leçon 23 · Avancé · Version : 3

Sources