std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: at
From cppreference.net
<
cpp
|
container
|
unordered map
|
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
と
KeyEqual
の両方が
transparent
である場合にのみ、オーバーロード解決に参加します。これは、そのような
Hash
が
K
型と
Key
型の両方で呼び出し可能であり、かつ
KeyEqual
がtransparentであることを前提としています。これらが組み合わさることで、
Key
のインスタンスを構築することなくこの関数を呼び出すことが可能になります。
目次 |
パラメータ
| key | - | 検索する要素のキー |
| x | - | キーと透過的に比較可能な任意の型の値 |
戻り値
要求された要素のマップされた値への参照。
例外
計算量
平均ケース: 定数時間、最悪ケース: サイズに対して線形時間。
注記
| 機能テスト マクロ | 値 | 標準 | 機能 |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | 順序付き および 非順序付き 連想 コンテナ の残りのメンバー関数に対する異種型オーバーロード。 ( 3,4 ) |
例
|
このセクションは不完全です
理由: 例がありません |
関連項目
|
指定された要素にアクセスまたは挿入する
(public member function) |
|
|
特定のキーを持つ要素を検索する
(public member function) |