Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri