Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::vector::clear — odstránenie všetkých prvkov bez zníženia kapacity

`std::vector::clear` zničí všetky prvky a nastaví veľkosť vektora na nulu, no kapacitu zachová na ďalšie vkladanie.

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

Syntax

#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á funkcia z <vector>: zavolaj v.clear() na vektore, ktorý nie je const. Neprijíma argumenty a nevracia hodnotu (void). Volanie ukončí životnosť všetkých prvkov. Potom platí v.size() == 0 a v.empty() vráti pravdu, aj keď bol vektor už predtým prázdny. Zložitosť je lineárna vzhľadom na počet prvkov pred volaním. Funkcia je noexcept od C++11 a constexpr od C++20.

Kapacita (v.capacity()) sa nemení. Pôvodné prvky tým však nezostávajú nažive: ukazovatele, referencie a iterátory na ne strácajú platnosť. Nepoužívaj ani predtým uložený iterátor end(); podľa potreby získaj nové iterátory pomocou begin() a end().

Použi clear(), keď chceš predchádzajúce výsledky nahradiť, nie k nim pridať ďalšie. Ak kopíruješ prvé prvky postupnosti, zaisti, aby zdroj zostal dostupný aj po vyprázdnení cieľa. clear() nie je bezpečné vymazanie obsahu pamäte; shrink_to_fit() je samostatná, nezáväzná požiadavka na zníženie kapacity.

Prí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ýsledok

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

Program obmedzí `k` na veľkosť samostatného zdrojového vektora, vyprázdni `names` a pridá vybrané prvé prvky. Porovná kapacitu pred vyprázdnením a po ňom bez predpokladu konkrétnej číselnej hodnoty.

Súvisiace lekcie

  • C++ · Lekcia 23 · Pokročilá · Verzia: 3

Zdroje