# std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>::clear

< cpp‎ | container‎ | unordered multimap

void clear() noexcept; |  | (C++11 起)

从容器擦除所有元素。此调用后 size() 返回零。

非法化任何指代所含元素的引用、指针或迭代器。可能亦非法化尾后迭代器。

### 参数

（无）

### 返回值

（无）

### 复杂度

与容器大小，即元素数成线性。

### 示例

    #include <algorithm>
    #include <iostream>
    #include <unordered_map>

    int main()
    {
        std::unordered_multimap<int, char> container{{1, 'x'}, {2, 'y'}, {3, 'z'}};

        auto print = [](std::pair<const int, char>& n) {
            std::cout << " " << n.first << '(' << n.second << ')';
        };

        std::cout << "Before clear:";
        std::for_each(container.begin(), container.end(), print);
        std::cout << "\nSize=" << container.size() << '\n';

        std::cout << "Clear\n";
        container.clear();

        std::cout << "After clear:";
        std::for_each(container.begin(), container.end(), print);
        std::cout << "\nSize=" << container.size() << '\n';
    }

可能的输出：

    Before clear: 1(x) 2(y) 3(z)
    Size=3
    Clear
    After clear:
    Size=0

### 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR | 应用于 | 出版时的行为 | 正确行为
--- | --- | --- | ---
LWG 2550 | C++11 | 对于无序关联容器，不清楚复杂度是与元素数还是桶数成线性 | 辨明它与元素数成线性

### 参阅

erase (C++11) | 擦除元素 (公开成员函数)