std::vector<T,Allocator>::clear

< cpp‎ | container‎ | vector

void clear();
(C++11 前)
void clear() noexcept;
(C++11 起)
(C++20 前)
constexpr void clear() noexcept;
(C++20 起)

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

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

保持 vectorcapacity() 不变(注意:更改容量上的标准限制在 vector::reserve 的规定中,见 [1] )。

参数

(无)

返回值

(无)

复杂度

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

示例

#include <algorithm>
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<int> container{1, 2, 3};
 
    auto print = [](const int& n) { std::cout << " " << n; };
 
    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 2 3
Size=3
Clear
After clear:
Size=0

缺陷报告

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

DR 应用于 出版时的行为 正确行为
LWG 2231 C++11 C++11 中错误地省略了复杂度保证 重申复杂度为线性


参阅

擦除元素
(公开成员函数)