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

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

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

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

参数

（无）

返回值

（无）

复杂度

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

示例

运行此代码
#include <algorithm>
#include <iostream>
#include <forward_list>
 
int main()
{
    std::forward_list<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 << '\n';
 
    std::cout << "Clear\n";
    container.clear();
 
    std::cout << "After clear:";
    std::for_each(container.begin(), container.end(), print);
    std::cout << '\n';
}

输出： 

Before clear: 1 2 3
Clear
After clear:

缺陷报告

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

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


参阅

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