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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

容器库

node-handle (C++17)

序列容器

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

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

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

视图

span (C++20)

mdspan (C++23)

表格

迭代器失效

成员函数表格

非成员函数表格

 

std::unordered_multimap

成员类型
成员函数
unordered_multimap::unordered_multimap unordered_multimap::~unordered_multimap    unordered_multimap::operator= unordered_multimap::get_allocator 迭代器 unordered_multimap::beginunordered_multimap::cbegin unordered_multimap::endunordered_multimap::cend 容量 unordered_multimap::size unordered_multimap::max_size unordered_multimap::empty 修改器 unordered_multimap::clear unordered_multimap::insert unordered_multimap::insert_range (C++23) unordered_multimap::emplace unordered_multimap::emplace_hint unordered_multimap::erase unordered_multimap::swap unordered_multimap::extract (C++17) unordered_multimap::merge (C++17)	查找 unordered_multimap::count unordered_multimap::find unordered_multimap::contains (C++20) unordered_multimap::equal_range 桶接口 unordered_multimap::begin(size_type)unordered_multimap::cbegin(size_type) unordered_multimap::end(size_type)unordered_multimap::cend(size_type) unordered_multimap::bucket_count unordered_multimap::max_bucket_count unordered_multimap::bucket_size unordered_multimap::bucket 散列策略 unordered_multimap::load_factor unordered_multimap::max_load_factor unordered_multimap::rehash unordered_multimap::reserve 观察器 unordered_multimap::hash_function unordered_multimap::key_eq
非成员函数
std::swap(std::unordered_multimap) erase_if(std::unordered_multimap) (C++20)	operator==operator!= (C++20 前)
推导指引(C++17)

 

void clear()noexcept;		(C++11 起) (C++26 起为 constexpr)

从容器擦除所有元素。此调用后 size() 返回零。

使任何指代所含元素的引用、指针和迭代器失效。 可能会使尾后迭代器也失效。

复杂度

与容器的大小，即元素数成线性。

示例

运行此代码

#include <iostream>#include <string_view>#include <unordered_map>   void print_info(std::string_view rem, conststd::unordered_multimap<int, char>& v){std::cout<< rem <<"{ ";for(constauto&[key, value]: v)std::cout<<'['<< key <<"]:"<< value <<' ';std::cout<<"}\n";std::cout<<"大小="<< v.size()<<'\n';}   int main(){std::unordered_multimap<int, char> container{{1, 'x'}, {2, 'y'}, {3, 'z'}}; print_info("clear 前：", container); container.clear(); print_info("clear 后：", container);}

可能的输出：

clear 前：{ [1]:x [2]:y [3]:z } 大小=3 clear 后：{ } 大小=0

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 2550	C++11	对于无序关联容器，不清楚复杂度是与元素数还是桶数成线性	辨明它与元素数成线性

参阅

erase

擦除元素 (公开成员函数)