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