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

void clear();

void clear() noexcept;

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

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

Параметры

(нет)

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

(нет)

Сложность

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

Пример

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

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

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

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

См. также