std::unordered_multiset<Key,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)	(с 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	-	значение любого типа, который может быть прозрачно сравнен с ключом

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

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

Сложность

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

Примечания

Макро-тест функции	Значение	Стандарт	Функция
`__cpp_lib_generic_unordered_lookup`	201811L	(C++20)	Гетерогенный поиск сравнения в неупорядоченных ассоциативных контейнерах; перегрузки (3,4)

Пример

#include <iostream>
#include <unordered_set>
 
 
 
int main()
{
    // Simple comparison demo.
    std::unordered_multiset<int> example = {1, 2, 3, 4};
 
    if (auto search = example.find(2); search != example.end())
        std::cout << "Found " << (*search) << '\n';
    else
        std::cout << "Not found\n";
 
 
 
 
}

Вывод:

Found 2

См. также

count	возвращает количество элементов, соответствующих заданному ключу (публичный член-функция)
equal_range	возвращает диапазон элементов, соответствующих заданному ключу (публичный член-функция)

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