std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: at
From cppreference.net
<
cpp
|
container
|
unordered map
|
T
&
at
(
const
Key
&
key
)
;
|
(1) | (自 C++11 起) |
|
const
T
&
at
(
const
Key
&
key
)
const
;
|
(2) | (自 C++11 起) |
|
template
<
class
K
>
T & at ( const K & x ) ; |
(3) | (自 C++26 起) |
|
template
<
class
K
>
const T & at ( const K & x ) const ; |
(4) | (自 C++26 起) |
返回指定键对应元素的映射值引用。若不存在该元素，则抛出 std::out_of_range 类型的异常。
1,2)
该键等同于
key
。
3,4)
该键与值
x
比较为
等价
。映射值的引用通过表达式
this
-
>
find
(
x
)
-
>
second
获取。
表达式
this
-
>
find
(
x
)
必须格式正确且具有明确定义的行为，否则其行为是未定义的。
这些重载仅在
Hash
与
KeyEqual
均为
透明函数对象
时才参与重载决议。这意味着此类
Hash
必须同时支持
K
和
Key
类型的调用，且
KeyEqual
具有透明性，二者共同使得无需构造
Key
的实例即可调用此函数。
目录 |
参数
| key | - | 要查找元素的键 |
| x | - | 可与键进行透明比较的任意类型值 |
返回值
对请求元素的映射值的引用。
异常
复杂度
平均情况：常数复杂度，最坏情况：与容器大小呈线性关系。
注释
| 功能测试 宏 | 值 | 标准 | 功能 |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | 为 有序 和 无序 关联 容器 中剩余成员函数提供异构重载 ( 3,4 ) |
示例
|
本节内容不完整
原因：缺少示例 |
参见
|
访问或插入指定元素
(公开成员函数) |
|
|
查找具有特定键的元素
(公开成员函数) |