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

size_type count( const Key& key ) const;	(1)	(since C++11)
template< class K > size_type count( const K& x ) const;	(2)	(since C++20)

1) Возвращает количество элементов с ключом, равным указанному аргументу key.

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

Параметры

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

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

1) Количество элементов с ключом key.

2) Количество элементов с ключом, эквивалентным x.

Сложность

линейна по количеству элементов с ключом key в среднем, в худшем случае линейна по размеру контейнера.

Примечания

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

Пример

#include <iostream>
#include <string>
#include <unordered_map>
 
int main()
{
    std::unordered_multimap<int, std::string> dict = {
        {1, "one"}, {6, "six"}, {3, "three"}
    };
    dict.insert({4, "four"});
    dict.insert({5, "five"});
    dict.insert({6, "six"});
 
    std::cout << "dict: { ";
    for (auto const& [key, value] : dict)
        std::cout << '[' << key << "]=" << value << ' ';
    std::cout << "}\n\n";
 
    for (int i{1}; i != 8; ++i)
        std::cout << "dict.count(" << i << ") = " << dict.count(i) << '\n';
}

Возможный вывод:

dict: { [5]=five [4]=four [1]=one [6]=six [6]=six [3]=three }
 
dict.count(1) = 1
dict.count(2) = 0
dict.count(3) = 1
dict.count(4) = 1
dict.count(5) = 1
dict.count(6) = 2
dict.count(7) = 0

См. также

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

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