std::unordered_multiset find() 方法

自 C++20 起

// (1) Non const version
iterator find( const Key& key );

// (2) Const version
const_iterator find( const Key& key ) const;

// (3) Non const version
template< class K >
iterator find( const K& x );

// (4) Const version
template< class K >
const_iterator find( const K& x ) const;

自 C++11 起

// (1) Non const version
iterator find( const Key& key );

// (2) Const version
const_iterator find( const Key& key ) const;

• (1-2) 查找键等同于 key 的元素。
• (3-4) 查找一个键与值 x 等效的元素。当 Hash::is_transparent 和 KeyEqual::is_transparent 有效并且各自表示一个类型时，此重载才会参与重载解析。这假设这样的 Hash 可以使用 K 和 Key 类型进行调用，并且 KeyEqual 是透明的，这允许在不构造 Key 实例的情况下调用此函数。

参数

• key - 要计数的元素的键值
• x - 可以与键透明比较的任何类型的值

返回值

指向键等效于 key 的元素的迭代器。如果找不到这样的元素，则返回尾后（请参阅 end()）迭代器。

复杂度

平均情况，常数 - O(1)。
最坏情况，与容器大小呈线性关系 - O(size())。

异常

(无)

备注

特性测试宏：__cpp_lib_generic_unordered_lookup（用于重载 (3-4)）。

示例

Main.cpp

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

可能输出

Found 2