std::map<Key,T,Compare,Allocator>::clear

void clear();		(до C++11)
void clear() noexcept;		(с C++11)

Удаляет все элементы из контейнера. После этого вызова, 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()`'

См. также

erase

удаляет элементы
(публичный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/map/clear