Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::vector::clear — eliminare tutti gli elementi senza ridurre la capacità

`std::vector::clear` distrugge tutti gli elementi e azzera la dimensione del vettore, mantenendo la capacità disponibile per inserimenti successivi.

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

Sintassi

#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 è una funzione membro di <vector>: chiama v.clear() su un vettore non const. Non accetta argomenti e non restituisce un valore (void). La chiamata termina la durata di vita di tutti gli elementi. In seguito, v.size() == 0 e v.empty() è vero, anche se il vettore era già vuoto. La complessità è lineare rispetto al numero di elementi prima della chiamata. La funzione è noexcept da C++11 e constexpr da C++20.

La capacità (v.capacity()) rimane invariata. Questo non mantiene in vita i vecchi elementi: i puntatori, i riferimenti e gli iteratori che li designano vengono invalidati. Non riutilizzare neppure un iteratore end() salvato prima della chiamata; ottieni nuovi iteratori con begin() e end() quando servono.

Usa clear() per sostituire i risultati precedenti anziché aggiungerne altri in coda. Se copi i primi elementi di una sequenza, assicurati che l’origine resti disponibile dopo aver svuotato la destinazione. clear() non cancella in modo sicuro il contenuto della memoria; shrink_to_fit() è una richiesta separata e non vincolante di ridurre la capacità.

Esempi

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

Risultato

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

Il programma limita `k` alla dimensione del vettore di origine separato, svuota `names` e aggiunge i primi elementi selezionati. Confronta la capacità prima e dopo lo svuotamento senza presupporre un valore numerico specifico.

Lezioni correlate

  • C++ · Lezione 23 · Avanzato · Versione: 3

Fonti