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

size_type count( const Key& key ) const;	(1)	(начиная с C++11)
template< class K > size_type count( const K& x ) const;	(2)	(начиная с C++20)

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

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

Параметры

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

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

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

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

Сложность

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

Примечания

Макрос проверки поддержки функции	Значение	Стандарт	Функция
`__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/cpp/container/unordered_multimap/count