Spec-Zone.ru › C++

std::unordered_set<Key,Hash,KeyEqual,Allocator>::clear

void clear() noexcept;
(since C++11)

Удаляет все элементы из контейнера. После этого вызова size() возвращает ноль.

Делает недействительными любые ссылки, указатели или итераторы, ссылающиеся на содержащиеся элементы. Также может сделать недействительными итераторы, указывающие за пределы контейнера.

Параметры

(нет)

Значение возврата

(нет)

Сложность

Линейная по размеру контейнера, т.е. по количеству элементов.

Пример

#include <iostream>
#include <string_view>
#include <unordered_set>
 
void print_info(std::string_view rem, const std::unordered_set<int>& v)
{
    std::cout << rem << "{ ";
    for (const auto& value : v)
        std::cout << value << ' ';
    std::cout << "}\n";
    std::cout << "Size=" << v.size() << '\n';
}
 
int main()
{
    std::unordered_set<int> container{1, 2, 3};
    print_info("Before clear: ", container);
    container.clear();
    print_info("After clear: ", container);
}

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

Before clear: { 1 2 3 }
Size=3
After clear: { }
Size=0

Отчеты об ошибках

Следующие отчеты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Применено к Поведение, как опубликовано Корректное поведение
LWG 2550 C++11 Для неупорядоченных ассоциативных контейнеров неясно, является ли сложность линейной по количеству элементов или по количеству бакетов Выяснено, что сложность линейная по количеству элементов

См. также

erase
удаляет элементы
(публичный член-функция)

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

Spec-Zone.ru

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