std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::find
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 | - | значение любого типа, которое можно прозрачно сравнить с ключом |
Возвращаемое значение
Итератор на запрошенный элемент. Если такой элемент не найден, возвращается итератор за последним элементом (см. 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
См. также
| возвращает количество элементов, соответствующих заданному ключу (открытая функция-член) |
|
| возвращает диапазон элементов, соответствующих заданному ключу (открытая функция-член) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/unordered_multiset/find