Namensräume
Varianten
Aktionen

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

Von cppreference.com
 
 
 
 
size_type count( const Key& key ) const;
(1) (seit C++11)
template< class K >
size_type count( const K& x ) const;
(2) (seit C++20)
1) Gibt die Anzahl der Elemente mit einem Schlüssel zurück, der mit dem angegebenen Argument key vergleichbar ist. Da dieser Container keine Duplikate zulässt, ist dieser Wert entweder 0 oder 1.
2) Gibt die Anzahl der Elemente mit einem Schlüssel zurück, der mit dem angegebenen Argument x äquivalent verglichen wird. Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn Hash::is_transparent und KeyEqual::is_transparent gültig sind und jeweils einen Typ bezeichnen. Dies setzt voraus, dass ein solches Hash sowohl mit dem Typ K als auch mit dem Typ Key aufrufbar ist und dass KeyEqual transparent ist, was zusammen ermöglicht, diese Funktion aufzurufen, ohne eine Instanz von Key zu konstruieren.

Inhalt

[bearbeiten] Parameter

key - Schlüsselwert der zu zählenden Elemente
x - ein Wert eines beliebigen Typs, der transparent mit einem Schlüssel verglichen werden kann

[bearbeiten] Rückgabewert

1) Anzahl der Elemente mit dem Schlüssel key, die entweder 1 oder 0 ist.
2) Anzahl der Elemente mit einem Schlüssel, der äquivalent zu x verglichen wird.

[bearbeiten] Komplexität

Im Durchschnitt konstant, im schlimmsten Fall linear zur Größe des Containers.

[bearbeiten] Anmerkungen

Feature-Test-Makro Wert Std Feature
__cpp_lib_generic_unordered_lookup 201811L (C++20) Heterogenes Vergleichssuchen in ungeordneten assoziativen Containern, Überladung (2)

[bearbeiten] Beispiel

#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';
}

Mögliche Ausgabe

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

[bearbeiten] Siehe auch

sucht ein Element mit einem bestimmten Schlüssel
(public member function) [edit]
(C++20)
prüft, ob der Container ein Element mit einem bestimmten Schlüssel enthält
(public member function) [edit]
gibt den Bereich von Elementen zurück, die einem bestimmten Schlüssel entsprechen
(public member function) [edit]