KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::vector::clear — alle elementen verwijderen met behoud van capaciteit

`std::vector::clear` vernietigt alle elementen en zet de grootte van de vector op nul, terwijl de capaciteit beschikbaar blijft voor latere invoegingen.

Versie: 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 is een lidfunctie uit <vector>: roep v.clear() aan op een vector die niet const is. De functie krijgt geen argumenten en geeft geen waarde terug (void). De aanroep beëindigt de levensduur van alle elementen. Daarna geldt v.size() == 0 en geeft v.empty() waar terug, ook als de vector al leeg was. De complexiteit is lineair in het aantal elementen vóór de aanroep. De functie is noexcept sinds C++11 en constexpr sinds C++20.

De capaciteit (v.capacity()) blijft ongewijzigd. Dat houdt de oude elementen niet in leven: pointers, referenties en iteratoren naar die elementen worden ongeldig. Gebruik ook geen eerder bewaarde end()-iterator opnieuw. Vraag zo nodig nieuwe iteratoren op met begin() en end().

Gebruik clear() als nieuwe resultaten de oude moeten vervangen in plaats van erachter te komen. Kopieer je de eerste elementen van een reeks, zorg dan dat de bron beschikbaar blijft nadat je de bestemming hebt geleegd. clear() wist de geheugeninhoud niet op een veilige manier; shrink_to_fit() is een afzonderlijk, niet-bindend verzoek om de capaciteit te verlagen.

Voorbeelden

#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';
    }
}

Resultaat

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

Het programma begrenst `k` op de grootte van de afzonderlijke bronvector, leegt `names` en voegt de geselecteerde eerste elementen toe. Het vergelijkt de capaciteit vóór en na het legen zonder een specifieke numerieke waarde aan te nemen.

Gerelateerde lessen

  • C++ · Les 23 · Gevorderd · Versie: 3

Bronnen