std::vector<T,Allocator>::clear
来自cppreference.com
void clear(); |
(C++11 起为 noexcept) (C++20 起为 constexpr) |
|
从容器擦除所有元素。此调用后 size() 返回零。
使任何指代所含元素的引用、指针和迭代器失效。 任何尾后迭代器也会失效。
目录 |
[编辑] 复杂度
与容器的大小，即元素数成线性。
注解
调用 clear() 不会影响 capacity() 的结果。标准中有关更改容量上的限制在 reserve() 的规定中给出，见 SO 帖子。
[编辑] 示例
运行此代码
#include <iostream> #include <string_view> #include <vector> void print_info(std::string_view rem, const std::vector<int>& v) { std::cout << rem << "{ "; for (const auto& value : v) std::cout << value << ' '; std::cout << "}\n"; std::cout << "大小=" << v.size() << "，容量=" << v.capacity() << '\n'; } int main() { std::vector<int> container{1, 2, 3}; print_info("clear 前：", container); container.clear(); print_info("clear 后：", container); }
输出：
clear 前：{ 1 2 3 }
大小=3，容量=3
clear 后：{ }
大小=0，容量=3缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 2231 | C++11 | C++11 中错误地省略了复杂度保证 | 重申复杂度为线性 |
[编辑] 参阅
| 擦除元素 (公开成员函数) |
