База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::vector::clear — премахване на всички елементи без намаляване на капацитета

`std::vector::clear` унищожава всички елементи и свежда размера на вектора до нула, като запазва капацитета за бъдещи вмъквания.

Версия: ISO C++23; implementation support may vary

Синтаксис

#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 е член-функция от <vector>: извикай v.clear() върху вектор, който не е const. Функцията не приема аргументи и не връща стойност (void). Извикването прекратява живота на всички елементи. След него v.size() == 0 и v.empty() връща истина, дори векторът вече да е бил празен. Сложността е линейна спрямо броя на елементите преди извикването. Функцията е noexcept от C++11 и constexpr от C++20.

Капацитетът (v.capacity()) не се променя. Това не запазва старите елементи: указателите, референциите и итераторите към тях стават невалидни. Не използвай повторно и запазен отпреди итератор end(); при нужда вземи нови итератори чрез begin() и end().

Използвай clear(), когато искаш да замениш старите резултати, вместо да добавяш нови след тях. Ако копираш първите елементи на последователност, източникът трябва да остане достъпен след изпразването на целевия вектор. clear() не изтрива сигурно съдържанието на паметта; shrink_to_fit() е отделна, необвързваща заявка за намаляване на капацитета.

Примери

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

Резултат

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

Програмата ограничава `k` до размера на отделния изходен вектор, изпразва `names` и добавя избраните първи елементи. Тя сравнява капацитета преди и след изпразването, без да предполага конкретна числова стойност.

Свързани уроци

  • C++ · Урок 23 · Напреднало · Версия: 3

Източници