unordered_map::at
描述 (Description)
C ++函数std::unordered_map::at()返回对与键k关联的映射值的引用。
声明 (Declaration)
以下是std :: unordered_map :: at()函数形式std :: unordered_map头的声明。
C++11
mapped_type& at(const key_type& k);
const mapped_type& at(const key_type& k) const;
参数 (Parameters)
k - 访问其映射值的键值。
返回值
如果object是常量限定的,则method返回对映射值的常量引用,否则返回非常量引用。
异常 (Exceptions)
如果key不存在,则方法返回out_of_range异常被抛出。
时间复杂
常数,即平均情况下为O(1)。
在最坏的情况下线性即O(n)。
例子 (Example)
以下示例显示了std :: unordered_map :: at()函数的用法。
#include <iostream>
#include <unordered_map>
using namespace std;
int main(void) {
unordered_map<char, int> um = {
{'a', 1},
{'b', 2},
{'c', 3},
{'d', 4},
{'e', 5}
};
cout << "Value of key um['a'] = " << um.at('a') << endl;
try {
um.at('z');
} catch(const out_of_range &e) {
cerr << "Exception at " << e.what() << endl;
}
return 0;
}
让我们编译并运行上面的程序,这将产生以下结果 -
Value of key um['a'] = 1
Exception at _Map_base::at