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

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

1,2) Находит элемент с ключом, эквивалентным key.

3,4) Находит элемент с ключом, который сравнивается как эквивалентный значению x. Этот перегруз участвует в разрешении перегрузки только если Hash::is_transparent и KeyEqual::is_transparent являются допустимыми типами. Предполагается, что такой Hash вызываем как с типом K, так и с типом Key, и что KeyEqual является прозрачным, что вместе позволяет вызвать эту функцию без создания экземпляра Key.

Параметры

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

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

Итератор на элемент с ключом, эквивалентным key. Если такой элемент не найден, возвращается итератор, указывающий на позицию за последним элементом (см. end()).

Сложность

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

Примечания

Макрокоманда проверки наличия функции	Значение	Стандарт	Функция
`__cpp_lib_generic_unordered_lookup`	201811L	(C++20)	Гетерогенный поиск по сравнению в неупорядоченных ассоциативных контейнерах; перегрузки (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	возвращает диапазон элементов, соответствующих заданному ключу (публичный член-функция)

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