Spec-Zone.ru › C++

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

bool contains( const Key& key ) const;
(1) (since C++20)
template< class K > bool contains( 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 - значение любого типа, которое может быть прозрачно сравнено с ключом

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

true если такой элемент существует, иначе false.

Сложность

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

Пример

#include <iostream>
#include <unordered_map>
 
int main()
{
    std::unordered_map<int, char> example = {{1, 'a'}, {2, 'b'}};
 
    for (int x : {2, 5})
    {
        if (example.contains(x))
            std::cout << x << ": Found\n";
        else
            std::cout << x << ": Not found\n";
    }
}

Вывод:

2: Found
5: Not found

См. также

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

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

Spec-Zone.ru

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