std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::at

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::is_transparent и KeyEqual::is_transparent корректны и каждый обозначает тип. Предполагается, что такой Hash может вызываться с типами K и Key, а KeyEqual является прозрачным, что в совокупности позволяет вызывать эту функцию без создания экземпляра Key.

Параметры

key	-	ключ искомого элемента
x	-	значение любого типа, которое можно прозрачно сравнить с ключом

Возвращаемое значение

Ссылка на отображаемое значение запрошенного элемента.

Исключения

1,2) std::out_of_range, если контейнер не содержит элемента с указанным key.

3,4) std::out_of_range, если контейнер не содержит указанный элемент, то есть если find(x) == end() равно true.

Сложность

В среднем случае: константная, в худшем случае: линейная по размеру.

Примечания

Макрос проверки поддержки возможности	Значение	Стандарт	Возможность
`__cpp_lib_associative_heterogeneous_insertion`	`202311L`	(C++26)	Гетерогенные перегрузки для остальных функций-членов упорядоченных ассоциативных и неупорядоченных ассоциативных контейнеров. (3,4)

Пример

См. также

operator[]	доступ к указанному элементу или его вставка (открытая функция-член)
find	находит элемент с указанным ключом (открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/unordered_map/at