std::map<Key,T,Compare,Allocator>:: clear
From cppreference.net
C++
Containers library
|
(C++17)
|
||||
| Sequence | ||||
|
(C++11)
|
||||
|
(C++26)
|
||||
|
(C++26)
|
||||
|
(C++11)
|
||||
| Associative | ||||
| Unordered associative | ||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
| Adaptors | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
| Views | ||||
|
(C++20)
|
||||
|
(C++23)
|
||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
std::map
| Member functions | |||||||||||||||||||||||||||
| Non-member functions | |||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||
| Deduction guides (C++17) | |||||||||||||||||||||||||||
|
void
clear
(
)
;
|
(noexcept начиная с C++11)
(constexpr начиная с C++26) |
|
Удаляет все элементы из контейнера. После этого вызова size() возвращает ноль.
Аннулирует любые ссылки, указатели и итераторы, ссылающиеся на содержащиеся элементы. Любой итератор за пределами контейнера остается действительным.
Содержание |
Сложность
Линейно относительно размера контейнера, то есть количества элементов.
Пример
Запустить этот код
#include <iostream> #include <string_view> #include <map> void print_info(std::string_view rem, const std::map<int, char>& v) { std::cout << rem << "{ "; for (const auto& [key, value] : v) std::cout << '[' << key << "]:" << value << ' '; std::cout << "}\n"; std::cout << "Size=" << v.size() << '\n'; } int main() { std::map<int, char> container{{1, 'x'}, {2, 'y'}, {3, 'z'}}; print_info("Before clear: ", container); container.clear(); print_info("After clear: ", container); }
Вывод:
Before clear: { [1]:x [2]:y [3]:z }
Size=3
After clear: { }
Size=0
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применяется к | Поведение в опубликованной версии | Корректное поведение |
|---|---|---|---|
| LWG 224 | C++98 | сложность составляла log ( size ( ) ) + N , но N не было определено | исправлено на 'линейная от size ( ) ' |
Смотрите также
|
удаляет элементы
(публичная функция-член) |