std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::begin, std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::cbegin

 

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_map

成员类型
成员函数
unordered_map::unordered_map unordered_map::~unordered_map unordered_map::operator= unordered_map::get_allocator 迭代器 unordered_map::beginunordered_map::cbegin unordered_map::endunordered_map::cend 容量 unordered_map::size unordered_map::max_size unordered_map::empty 修改器 unordered_map::clear unordered_map::erase unordered_map::swap unordered_map::extract (C++17) unordered_map::merge (C++17) unordered_map::insert unordered_map::insert_range (C++23) unordered_map::insert_or_assign (C++17)   unordered_map::emplace unordered_map::emplace_hint unordered_map::try_emplace (C++17)	查找 unordered_map::at unordered_map::operator[] unordered_map::count unordered_map::find unordered_map::contains (C++20) unordered_map::equal_range 桶接口 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 散列策略 unordered_map::load_factor unordered_map::max_load_factor unordered_map::rehash unordered_map::reserve 观察器 unordered_map::hash_function unordered_map::key_eq
非成员函数
operator==operator!= (C++20 前)	std::swap(std::unordered_map) erase_if(std::unordered_map) (C++20)
推导指引(C++17)

 

iterator begin()noexcept;	(1)	(C++11 起) (C++26 起为 constexpr)
const_iterator begin()constnoexcept;	(2)	(C++11 起) (C++26 起为 constexpr)
const_iterator cbegin()constnoexcept;	(3)	(C++11 起) (C++26 起为 constexpr)

返回指向 *this 的首元素的迭代器。

如果 *this 为空，那么返回的迭代器等于 end()。

返回值

指向首元素的迭代器。

复杂度

常数。

示例

运行此代码

#include <cmath>#include <iostream>#include <unordered_map>   struct Node {double x, y;};   int main(){ Node nodes[3]={{1, 0}, {2, 0}, {3, 0}};   // mag 是映射 Node 地址到其平面中长度的 mapstd::unordered_map<Node*, double> mag ={{ nodes +0, 1}, { nodes +1, 2}, { nodes +2, 3}};   // 从 0 到长度更改每个 y 坐标for(auto iter = mag.begin(); iter != mag.end();++iter){auto cur = iter->first;// 指向 Node 的指针 cur->y = mag[cur];// 亦能使用 cur->y = iter->second;}   // 更新并打印每个结点的长度for(auto iter = mag.begin(); iter != mag.end();++iter){auto cur = iter->first; mag[cur]=std::hypot(cur->x, cur->y);std::cout<<"The magnitude of ("<< cur->x <<", "<< cur->y <<") is ";std::cout<< iter->second <<'\n';}   // 以基于范围的 for 循环重复上述内容for(auto i : mag){auto cur = i.first; cur->y = i.second; mag[cur]=std::hypot(cur->x, cur->y);std::cout<<"The magnitude of ("<< cur->x <<", "<< cur->y <<") is ";std::cout<< mag[cur]<<'\n';// 注意与上述 std::cout << iter->second << '\n'; 相反，// std::cout << i.second << '\n'; 将不会打印更新的长度}}

可能的输出：

The magnitude of (3, 3) is 4.24264 The magnitude of (1, 1) is 1.41421 The magnitude of (2, 2) is 2.82843 The magnitude of (3, 4.24264) is 5.19615 The magnitude of (1, 1.41421) is 1.73205 The magnitude of (2, 2.82843) is 3.4641

参阅

endcend	返回指向末尾的迭代器 (公开成员函数)
begincbegin (C++11)(C++14)	返回指向容器或数组起始的迭代器 (函数模板)