Spec-Zone.ru › C++

std::unordered_map<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, что либо ​0​ или 1, поскольку в этом контейнере не допускаются дубликаты.
2) Возвращает количество элементов с ключом, эквивалентным указанному аргументу x. Этот перегруз участвует в разрешении перегрузки только если Hash::is_transparent и KeyEqual::is_transparent являются допустимыми типами. Предполагается, что такой Hash вызывается как с K, так и с Key типом, и что KeyEqual является прозрачным, что вместе позволяет вызвать эту функцию без создания экземпляра Key.

Параметры

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

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

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

Сложность

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

Примечания

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

Пример

#include <iostream>
#include <string>
#include <unordered_map>
 
int main()
{
    std::unordered_map<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 [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) = 1
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_map/count

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API