WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::vector::clear — alle Elemente entfernen, Kapazität behalten

`std::vector::clear` zerstört alle Elemente und setzt die Größe des Vektors auf null, behält aber die Kapazität für spätere Einfügungen bei.

Version: 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 ist eine Memberfunktion aus <vector>: Rufe v.clear() für einen Vektor auf, der nicht const ist. Die Funktion nimmt keine Argumente entgegen und liefert keinen Wert (void). Der Aufruf beendet die Lebensdauer aller Elemente. Danach gilt v.size() == 0, und v.empty() ist wahr, auch wenn der Vektor schon leer war. Die Komplexität ist linear in der Anzahl der Elemente vor dem Aufruf. Die Funktion ist seit C++11 noexcept und seit C++20 constexpr.

Die Kapazität (v.capacity()) bleibt unverändert. Die alten Elemente bleiben dadurch nicht am Leben: Zeiger, Referenzen und Iteratoren auf sie werden ungültig. Verwende auch keinen gespeicherten end()-Iterator weiter. Ermittle bei Bedarf begin() und end() neu.

Verwende clear(), um alte Ergebnisse zu ersetzen, statt neue anzuhängen. Wenn du die ersten Elemente eines Bereichs kopierst, muss die Quelle auch nach dem Leeren des Ziels verfügbar sein. clear() löscht Speicherinhalte nicht sicher; shrink_to_fit() ist eine separate, unverbindliche Anforderung, die Kapazität zu verringern.

Beispiele

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

Ergebnis

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

Das Programm begrenzt `k` auf die Größe des separaten Quellvektors, leert `names` und hängt die ausgewählten ersten Elemente an. Es vergleicht die Kapazität vor und nach dem Leeren, ohne einen bestimmten Zahlenwert vorauszusetzen.

Zugehörige Lektionen

  • C++ · Lektion 23 · Fortgeschritten · Version: 3

Quellen