std::vector<T,Allocator>::clear

void clear();

void clear() noexcept;

constexpr void clear() noexcept;

Удаляет все элементы из контейнера. После этого вызова size() возвращает ноль.

Делает недействительными любые ссылки, указатели или итераторы, ссылающиеся на содержащиеся элементы. Любые итераторы, указывающие за границами контейнера, также становятся недействительными.

Оставляет capacity() вектора неизмененным (Примечание: ограничение стандарта на изменения емкости указано в спецификации vector::reserve, см. [1]).

Параметры

(нет)

Возвращаемое значение

(нет)

Сложность

Линейная относительно размера контейнера, то есть количества элементов.

Пример

#include <iostream>
#include <string_view>
#include <vector>
 
void print_info(std::string_view rem, const std::vector<int>& v)
{
    std::cout << rem << "{ ";
    for (const auto& value : v)
        std::cout << value << ' ';
    std::cout << "}\n";
    std::cout << "Size=" << v.size() << ", Capacity=" << v.capacity() << '\n';
}
 
int main()
{
    std::vector<int> container{1, 2, 3};
    print_info("Before clear: ", container);
    container.clear();
    print_info("After clear: ", container);
}

Before clear: { 1 2 3 }
Size=3, Capacity=3
After clear: { }
Size=0, Capacity=3

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также