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

< cpp‎ | container‎ | vector

 
C++
 
容器库
 
std::vector
成员函数
元素访问
(C++11)
迭代器
(C++11)
(C++11)
(C++11)
(C++11)
容量
(C++11)
修改器
vector::clear
(C++11)
(C++11)
非成员函数
(C++20)(C++20)
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
推导指引(C++17)
 
void clear();
 (C++11 前)
void clear() noexcept;
 (C++11 起)
(C++20 前)
constexpr void clear() noexcept;
 (C++20 起)

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

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

保持 vector 的 capacity() 不变（注意：更改容量上的标准限制在 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 中错误地省略了复杂度保证 重申复杂度为线性


参阅

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