[#nlohmann-ordered_map-at-08]
= xref:nlohmann.adoc[nlohmann]::xref:nlohmann/ordered_map.adoc[ordered_map]::at
:relfileprefix: ../../
:mrdocs:

accesses the element with the given key, with bounds checking

== Synopsis

Declared in `<nlohmann/ordered_map.hpp>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
T const&
at(xref:nlohmann/ordered_map/key_type.adoc[key_type] const& key) const;
----

== Exceptions

[cols="1,4"]
|===
| Name| Thrown on
| `std::out_of_range`
| if the container does not have an element with the given key
|===

== Return Value

const reference to the value associated with _key_

== Parameters

[cols="1,4"]
|===
| Name| Description
| *key* [in]
| key of the element to access
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#