std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>::find

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

コンテナライブラリ

シーケンス

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

連想

set

multiset

map

multimap

非順序連想

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

アダプタ

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

表示

span (C++20)

mdspan (C++23)

表

イテレータの無効化

メンバ関数テーブル

非メンバ関数テーブル

 

std::unordered_multimap

メンバ型
メンバ関数
unordered_multimap::unordered_multimap unordered_multimap::~unordered_multimap    unordered_multimap::operator= unordered_multimap::get_allocator イテレータ unordered_multimap::beginunordered_multimap::cbegin unordered_multimap::endunordered_multimap::cend 容量 unordered_multimap::size unordered_multimap::max_size unordered_multimap::empty 変更 unordered_multimap::clear unordered_multimap::insert unordered_multimap::insert_range (C++23) unordered_multimap::emplace unordered_multimap::emplace_hint unordered_multimap::erase unordered_multimap::swap unordered_multimap::extract (C++17) unordered_multimap::merge (C++17)	検索 unordered_multimap::count unordered_multimap::find unordered_multimap::contains (C++20) unordered_multimap::equal_range バケットインターフェース unordered_multimap::begin(size_type)unordered_multimap::cbegin(size_type) unordered_multimap::end(size_type)unordered_multimap::cend(size_type) unordered_multimap::bucket_count unordered_multimap::max_bucket_count unordered_multimap::bucket_size unordered_multimap::bucket ハッシュポリシー unordered_multimap::load_factor unordered_multimap::max_load_factor unordered_multimap::rehash unordered_multimap::reserve 監視 unordered_multimap::hash_function unordered_multimap::key_eq
非メンバ関数
std::swap(std::unordered_multimap) erase_if(std::unordered_multimap) (C++20)	operator==operator!= (C++20まで)
推論補助 (C++17)

 

iterator find( const Key& key );	(1)	(C++11以降)
const_iterator find( const Key& key ) const;	(2)	(C++11以降)
template< class K > iterator find( const K& x );	(3)	(C++20以降)
template< class K > const_iterator find( const K& x ) const;	(4)	(C++20以降)

1,2) キーがkeyと等価な要素を検索します。コンテナ内に要求されたキーを持つ要素が複数ある場合、それらのいずれかが返される可能性があります。

3,4) キーが値 x と 同等 である要素を検索します。このオーバーロードは、Hash::is_transparent および KeyEqual::is_transparent が有効で、それぞれが型を示す場合にのみオーバーロード解決に参加します。これは、そのようなHashがKとKeyの両方の型で呼び出し可能であり、KeyEqualが透過的であることを前提としており、これらを組み合わせることでKeyのインスタンスを構築せずにこの関数を呼び出すことができます。

パラメータ

key	-	検索する要素のキー値
x	-	キーと透過的に比較できる任意の型の値

戻り値

要求された要素へのイテレータ。そのような要素が見つからない場合は、past-the-end ( end() を参照) イテレータが返されます。

計算量

平均的には定数時間、最悪の場合はコンテナのサイズに線形時間。

注釈

機能テストマクロ	値	規格	機能
__cpp_lib_generic_unordered_lookup	201811L	(C++20)	unordered associative containers における異種比較ルックアップ。オーバーロード (3,4)

例

このコードを実行

#include <iostream>
#include <unordered_map>
 
int main()
{
    // Simple comparison demo.
    std::unordered_multimap<int, char> example{{1, 'a'}, {2, 'b'}};
 
    if (auto search = example.find(2); search != example.end())
        std::cout << "Found " << search->first << ' ' << search->second << '\n';
    else
        std::cout << "Not found\n";
}

出力

Found 2 b

関連項目

count	特定のキーに一致する要素の数を返す (公開メンバ関数)
equal_range	特定のキーに一致する要素の範囲を返す (公開メンバ関数)