std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::clear

void clear() noexcept;		(since C++11)

Erases all elements from the container. After this call, size() returns zero.

Invalidates any references, pointers, or iterators referring to contained elements. May also invalidate past-the-end iterators.

Parameters

(none)

Return value

(none)

Complexity

Linear in the size of the container, i.e., the number of elements.

Example

Run this code

#include <algorithm>
#include <iostream>
#include <unordered_map>
 
int main()
{
    std::unordered_map<int, char> container{{1, 'x'}, {2, 'y'}, {3, 'z'}};
 
    auto print = [](std::pair<const int, char>& n) { 
        std::cout << " " << n.first << '(' << n.second << ')'; 
    };
 
    std::cout << "Before clear:";
    std::for_each(container.begin(), container.end(), print);
    std::cout << "\nSize=" << container.size() << '\n';
 
    std::cout << "Clear\n";
    container.clear();
 
    std::cout << "After clear:";
    std::for_each(container.begin(), container.end(), print);
    std::cout << "\nSize=" << container.size() << '\n';
}

Possible output:

Before clear: 1(x) 2(y) 3(z)
Size=3
Clear
After clear:
Size=0

Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR	Applied to	Behavior as published	Correct behavior
LWG 2550	C++11	for unordered associative containers, unclear if complexity is linear in the number of elements or buckets	clarified that it's linear in the number of elements

Language
Standard Library Headers
Freestanding and hosted implementations
Named requirements
Language support library
Concepts library (C++20)
Diagnostics library
Utilities library
Strings library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Numerics library
Localizations library
Input/output library
Filesystem library (C++17)
Regular expressions library (C++11)
Atomic operations library (C++11)
Thread support library (C++11)
Technical Specifications

array (C++11)
vector
deque
forward_list (C++11)
list
set
multiset
map
multimap
unordered_set (C++11)
unordered_multiset (C++11)
unordered_map (C++11)
unordered_multimap (C++11)
stack
queue
priority_queue
span (C++20)

Member functions
unordered_map::unordered_map
unordered_map::~unordered_map
unordered_map::operator=
unordered_map::get_allocator
Iterators
unordered_map::beginunordered_map::cbegin
unordered_map::endunordered_map::cend
Capacity
unordered_map::empty
unordered_map::size
unordered_map::max_size
Modifiers
unordered_map::clear
unordered_map::insert
unordered_map::insert_or_assign (C++17)
unordered_map::emplace
unordered_map::emplace_hint
unordered_map::try_emplace (C++17)
unordered_map::erase
unordered_map::swap
unordered_map::extract (C++17)
unordered_map::merge (C++17)
Lookup
unordered_map::at
unordered_map::operator[]
unordered_map::count
unordered_map::find
unordered_map::contains (C++20)
unordered_map::equal_range
Bucket interface
unordered_map::begin(size_type)unordered_map::cbegin(size_type)
unordered_map::end(size_type)unordered_map::cend(size_type)
unordered_map::bucket_count
unordered_map::max_bucket_count
unordered_map::bucket_size
unordered_map::bucket
Hash policy
unordered_map::load_factor
unordered_map::max_load_factor
unordered_map::rehash
unordered_map::reserve
Observers
unordered_map::hash_function
unordered_map::key_eq
Non-member functions
operator==operator!= (until C++20)
std::swap
erase_if (C++20)
Deduction guides(C++17)