CKTIS / C++
std::vector::clear — uklanjanje svih elemenata bez smanjenja kapaciteta
`std::vector::clear` uništava sve elemente i postavlja veličinu vektora na nulu, a kapacitet zadržava za kasnija umetanja.
Verzija: ISO C++23; implementation support may vary
Sintaksa
#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 funkcija je članica iz <vector>: pozovi v.clear() na vektoru koji nije const. Ne prima argumente i ne vraća vrijednost (void). Poziv završava životni vijek svih elemenata. Nakon njega vrijedi v.size() == 0 i v.empty() vraća istinitu vrijednost, čak i ako je vektor već bio prazan. Složenost je linearna u odnosu na broj elemenata prije poziva. Funkcija je noexcept od C++11 i constexpr od C++20.
Kapacitet (v.capacity()) ostaje nepromijenjen. To ne održava stare elemente na životu: pokazivači, reference i iteratori na njih postaju nevaljani. Nemoj ponovno upotrijebiti ni ranije spremljeni iterator end(); prema potrebi dohvati nove iteratore pomoću begin() i end().
Upotrijebi clear() kada želiš zamijeniti prethodne rezultate umjesto da im dodaš nove. Ako kopiraš prve elemente slijeda, osiguraj da izvor ostane dostupan nakon pražnjenja odredišta. clear() ne briše sadržaj memorije na siguran način; shrink_to_fit() zaseban je i neobvezujući zahtjev za smanjenje kapaciteta.
Primjeri
#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';
}
}Rezultat
size after clear: 0 capacity unchanged: true replacement names: Ada Lin
Program ograničava `k` na veličinu zasebnog izvornog vektora, prazni `names` i dodaje odabrane prve elemente. Uspoređuje kapacitet prije i nakon pražnjenja bez pretpostavke o njegovoj konkretnoj brojčanoj vrijednosti.
Povezane lekcije
- C++ · Lekcija 23 · Napredno · Verzija: 3