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

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Container-Bibliothek

Sequenz

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

Assoziativ

setzt

multiset

map

multimap

Ungeordnete assoziative

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adapter

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Ansichten

span (C++20)

mdspan (C++23)

Tabellen

Iterator-Invalidierung

Mitgliedsfunktionstabelle

Nicht-Mitgliedsfunktionstabelle

 

std::unordered_map

Membertypen
Memberfunktionen
unordered_map::unordered_map unordered_map::~unordered_map unordered_map::operator= unordered_map::get_allocator Iteratoren unordered_map::beginunordered_map::cbegin unordered_map::endunordered_map::cend Kapazität unordered_map::size unordered_map::max_size unordered_map::empty Modifizierer unordered_map::clear unordered_map::erase unordered_map::swap unordered_map::extract (C++17) unordered_map::merge (C++17) unordered_map::insert unordered_map::insert_range (C++23) unordered_map::insert_or_assign (C++17)   unordered_map::emplace unordered_map::emplace_hint unordered_map::try_emplace (C++17)	Suche unordered_map::at unordered_map::operator[] unordered_map::count unordered_map::find unordered_map::contains (C++20) unordered_map::equal_range Bucket-Schnittstelle unordered_map::begin(size_type)unordered_map::cbegin(size_type) unordered_map::end(size_type)unordered_map::cend(size_type) unordered_map::bucket_count unordered_map::max_bucket_count unordered_map::bucket_size unordered_map::bucket Hash-Politik unordered_map::load_factor unordered_map::max_load_factor unordered_map::rehash unordered_map::reserve Observer unordered_map::hash_function unordered_map::key_eq
Nicht-Member-Funktionen
operator==operator!= (bis C++20)	std::swap(std::unordered_map) erase_if(std::unordered_map) (C++20)
Abzugsführer(C++17)

 

T& at( const Key& key );	(1)	(seit C++11)
const T& at( const Key& key ) const;	(2)	(seit C++11)
template< class K > T& at( const K& x );	(3)	(seit C++26)
template< class K > const T& at( const K& x ) const;	(4)	(seit C++26)

Gibt eine Referenz auf den zugeordneten Wert des Elements mit dem angegebenen Schlüssel zurück. Wenn kein solches Element existiert, wird eine Ausnahme vom Typ std::out_of_range ausgelöst.

1,2) Der Schlüssel ist äquivalent zu key.

3,4) Der Schlüssel ist *äquivalent* zu dem Wert x. Die Referenz auf den zugeordneten Wert wird erhalten, als ob durch den Ausdruck this->find(x)->second.

Der Ausdruck this->find(x) muss wohlgeformt sein und ein wohldefiniertes Verhalten haben, andernfalls ist das Verhalten undefiniert.

Diese Überladungen nehmen an der Überladungsauflösung nur teil, wenn Hash::is_transparent und KeyEqual::is_transparent gültig sind und jeweils einen Typ bezeichnen. Dies setzt voraus, dass ein solches Hash sowohl mit den Typen K als auch Key aufrufbar ist und dass KeyEqual transparent ist, was zusammen die Aufrufbarkeit dieser Funktion ermöglicht, ohne eine Instanz von Key zu konstruieren.

Parameter

key	-	der Schlüssel des zu findenden Elements
x	-	ein Wert eines beliebigen Typs, der transparent mit einem Schlüssel verglichen werden kann

Rückgabewert

Eine Referenz auf den zugeordneten Wert des angeforderten Elements.

Ausnahmen

1,2) std::out_of_range, wenn der Container kein Element mit dem angegebenen key hat.

3,4) std::out_of_range, wenn der Container das angegebene Element nicht hat, d.h. wenn find(x) == end() true ist.

Komplexität

Durchschnittlicher Fall: konstant, schlimmster Fall: linear in der Größe.

Anmerkungen

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_associative_heterogeneous_insertion	202311L	(C++26)	Heterogene Überladungen für die übrigen Member-Funktionen in geordneten und ungeordneten assoziativen Containern. (3,4)

Siehe auch

operator[]	greift auf ein Element zu oder fügt es ein (public member function)
find	sucht ein Element mit einem bestimmten Schlüssel (public member function)