std::map<Key,T,Compare,Allocator>:: at
From cppreference.net
|
T
&
at
(
const
Key
&
key
)
;
|
(1) | |
|
const
T
&
at
(
const
Key
&
key
)
const
;
|
(2) | |
|
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
)
должно быть корректно сформированным и иметь определённое поведение, иначе поведение не определено.
Эти перегрузки участвуют в разрешении перегрузки только если
Compare
является
прозрачным
. Это позволяет вызывать данную функцию без создания экземпляра
Key
.
Содержание |
Параметры
| key | - | ключ элемента для поиска |
| x | - | значение любого типа, которое можно прозрачно сравнивать с ключом |
Возвращаемое значение
Ссылка на отображенное значение запрашиваемого элемента.
Исключения
3,4)
std::out_of_range
если контейнер не содержит указанный элемент, то есть если
find
(
x
)
==
end
(
)
равно
true
.
Сложность
Логарифмическая от размера контейнера.
Примечания
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | Гетерогенные перегрузки для оставшихся функций-членов в упорядоченных и неупорядоченных ассоциативных контейнерах . ( 3,4 ) |
Пример
Запустить этот код
#include <cassert> #include <iostream> #include <map> struct LightKey { int o; }; struct HeavyKey { int o[1000]; }; // Контейнер должен использовать std::less<> (или другой прозрачный компаратор) для // доступа к перегрузкам (3,4). Это включает стандартные перегрузки, такие как // сравнение между std::string и std::string_view. bool operator<(const HeavyKey& x, const LightKey& y) { return x.o[0] < y.o; } bool operator<(const LightKey& x, const HeavyKey& y) { return x.o < y.o[0]; } bool operator<(const HeavyKey& x, const HeavyKey& y) { return x.o[0] < y.o[0]; } int main() { std::map<int, char> map{{1, 'a'}, {2, 'b'}}; assert(map.at(1) == 'a'); assert(map.at(2) == 'b'); try { map.at(13); } catch(const std::out_of_range& ex) { std::cout << "1) out_of_range::what(): " << ex.what() << '\n'; } #ifdef __cpp_lib_associative_heterogeneous_insertion // Демонстрация прозрачного сравнения. std::map<HeavyKey, char, std::less<>> map2{{{1}, 'a'}, {{2}, 'b'}}; assert(map2.at(LightKey{1}) == 'a'); assert(map2.at(LightKey{2}) == 'b'); try { map2.at(LightKey{13}); } catch(const std::out_of_range& ex) { std::cout << "2) out_of_range::what(): " << ex.what() << '\n'; } #endif }
Возможный вывод:
1) out_of_range::what(): map::at: key not found 2) out_of_range::what(): map::at: key not found
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применяется к | Поведение в опубликованной версии | Корректное поведение |
|---|---|---|---|
| LWG 464 | C++98 |
map
не имел этой функции-члена
|
добавлена |
| LWG 703 | C++98 | требование к сложности отсутствовало | добавлено |
| LWG 2007 | C++98 | возвращаемое значение ссылалось на запрошенный элемент | ссылается на его сопоставленное значение |
Смотрите также
|
доступ или вставка указанного элемента
(public member function) |
|
|
находит элемент с указанным ключом
(public member function) |