CKTIS / C++
std::vector::clear — odstranitev vseh elementov brez zmanjšanja kapacitete
`std::vector::clear` uniči vse elemente in nastavi velikost vektorja na nič, kapaciteto pa ohrani za poznejše vstavljanje.
Različica: 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 je članska funkcija iz <vector>: pokliči v.clear() na vektorju, ki ni const. Funkcija ne sprejme argumentov in ne vrne vrednosti (void). Klic konča življenjsko dobo vseh elementov. Po njem velja v.size() == 0 in v.empty() vrne resnično vrednost, tudi če je bil vektor že prazen. Časovna zahtevnost je linearna glede na število elementov pred klicem. Funkcija je noexcept od C++11 in constexpr od C++20.
Kapaciteta (v.capacity()) ostane nespremenjena. To ne ohrani starih elementov pri življenju: kazalci, reference in iteratorji nanje postanejo neveljavni. Ne uporabi znova niti prej shranjenega iteratorja end(); po potrebi pridobi nova iteratorja z begin() in end().
Uporabi clear(), ko želiš stare rezultate zamenjati, ne pa jim dodati novih. Če kopiraš prve elemente zaporedja, poskrbi, da bo vir na voljo tudi po izpraznitvi ciljnega vektorja. clear() vsebine pomnilnika ne izbriše varno; shrink_to_fit() je ločena, nezavezujoča zahteva za zmanjšanje kapacitete.
Primeri
#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 omeji `k` na velikost ločenega izvornega vektorja, izprazni `names` in doda izbrane prve elemente. Kapaciteto primerja pred izpraznitvijo in po njej, ne da bi predpostavil določeno številsko vrednost.
Povezane lekcije
- C++ · Lekcija 23 · Napredna · Različica: 3