CKTIS / C++
std::vector::clear — odstranění všech prvků bez snížení kapacity
`std::vector::clear` zničí všechny prvky a nastaví velikost vektoru na nulu, ale jeho kapacitu zachová pro další vkládání.
Verze: 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 je členská funkce z <vector>: zavolej v.clear() na vektoru, který není const. Nepřijímá žádné argumenty a nevrací hodnotu (void). Volání ukončí dobu života všech prvků. Poté platí v.size() == 0 a v.empty() vrací pravdu, i když byl vektor už předtím prázdný. Složitost je lineární vzhledem k počtu prvků před voláním. Funkce je noexcept od C++11 a constexpr od C++20.
Kapacita (v.capacity()) se nemění. Původní prvky tím ale nezůstávají naživu: ukazatele, reference a iterátory na tyto prvky ztrácejí platnost. Nepoužívej ani dříve uložený iterátor end(); podle potřeby získej nové iterátory pomocí begin() a end().
Použij clear(), když chceš předchozí výsledky nahradit, ne k nim přidávat další. Kopíruješ-li první prvky posloupnosti, zajisti, aby zdroj zůstal dostupný i po vyprázdnění cíle. clear() není bezpečné vymazání obsahu paměti; shrink_to_fit() je samostatný, nezávazný požadavek na snížení kapacity.
Příklady
#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';
}
}Výsledek
size after clear: 0 capacity unchanged: true replacement names: Ada Lin
Program omezí `k` na velikost samostatného zdrojového vektoru, vyprázdní `names` a přidá vybrané první prvky. Porovná kapacitu před vyprázdněním a po něm, aniž by předpokládal konkrétní číselnou hodnotu.
Související lekce
- C++ · Lekce 23 · Pokročilá · Verze: 3