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

来自cppreference.com
< cpp‎ | container‎ | map

 
 
 
 
T& at( const Key& key );
(1)
const T& at( const Key& key ) const;
(2)

返回到拥有等于 key 的关键的元素被映射值的引用。如果没有这种元素,那么就会抛出 std::out_of_range 类型异常。

参数

key - 要找到的元素的关键

返回值

到请求元素的被映射值的引用。

异常

在容器没有指定 key 的元素时抛出 std::out_of_range

复杂度

与容器大小成对数。

缺陷报告

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

缺陷报告 应用于 出版时的行为 正确行为
LWG 464 C++98 map 没有这个成员函数 添加该函数
LWG 703 C++98 缺失了复杂度要求 已补充
LWG 2007 C++98 返回值指代请求元素 指代该元素的被映射值

参阅

访问或插入指定的元素
(公开成员函数)