std::map<Key,T,Compare,Allocator>::at
T& at( const Key& key ); | (1) | |
const T& at( const Key& key ) const; | (2) |
Возвращает ссылку на сопоставленное значение элемента с ключом, эквивалентным key. Если такого элемента не существует, выбрасывается исключение типа std::out_of_range.
Параметры
| key | - | ключ искомого элемента |
Возвращаемое значение
Ссылка на сопоставленное значение запрошенного элемента.
Исключения
std::out_of_range если в контейнере нет элемента со указанным key.
Сложность
Логарифмическая по размеру контейнера.
Отчеты об ошибках
Следующие отчеты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применено к | Поведение как опубликовано | Правильное поведение |
|---|---|---|---|
| LWG 464 | C++98 |
map не имела этой функции-члена | добавлено |
| LWG 703 | C++98 | требование по сложности отсутствовало | добавлено |
| LWG 2007 | C++98 | возвращаемое значение ссылалось на запрошенный элемент | ссылается на его сопоставленное значение |
См. также
| доступ или вставка указанного элемента (публичная функция-член) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/map/at
