CKTIS / C++
std::vector::clear — usuń elementy bez zmniejszania pojemności
`std::vector::clear` niszczy wszystkie elementy wektora i zeruje jego rozmiar, ale zachowuje pojemność na kolejne wstawienia.
Wersja: ISO C++23; implementation support may vary
Składnia
#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 to funkcja składowa z <vector>: wywołaj v.clear() na wektorze, który nie jest const. Nie przyjmuje argumentów i nic nie zwraca (void). Wywołanie kończy czas życia wszystkich elementów; potem v.size() == 0 i v.empty() jest prawdą, także gdy wektor był już pusty. Złożoność jest liniowa względem liczby elementów przed wywołaniem. Funkcja jest noexcept od C++11 i constexpr od C++20.
Pojemność (v.capacity()) pozostaje bez zmian. Nie oznacza to, że dawne elementy nadal istnieją: ich wskaźniki, referencje i iteratory tracą ważność. Nie używaj też zapamiętanego end(); w razie potrzeby pobierz nowe begin() i end().
Użyj clear(), gdy chcesz zastąpić poprzedni wynik, a nie dopisać do niego dane. Jeśli kopiujesz początek zakresu, źródło musi pozostać dostępne po wyczyszczeniu wektora docelowego. clear() nie służy do bezpiecznego wymazywania danych z pamięci; shrink_to_fit() to osobne, niewiążące żądanie zmniejszenia pojemności.
Przykłady
#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';
}
}Wynik
size after clear: 0 capacity unchanged: true replacement names: Ada Lin
Program ogranicza `k` do rozmiaru odrębnego wektora źródłowego, czyści `names`, a następnie dopisuje wybrany początek źródła. Porównuje pojemność przed i po czyszczeniu, nie zakładając jej konkretnej wartości.
Powiązane lekcje
- C++ · Lekcja 23 · Zaawansowany · Wersja: 3