std::list<T,Allocator>::erase
(1) | ||
iterator erase( iterator pos ); |
(C++11 前) | |
iterator erase( const_iterator pos ); |
(C++11 起) | |
(2) | ||
iterator erase( iterator first, iterator last ); |
(C++11 前) | |
iterator erase( const_iterator first, const_iterator last ); |
(C++11 起) | |
从容器擦除指定的元素。
1) 移除位于
pos
的元素。2) 移除范围
[first; last)
中的元素。指向被擦除元素的迭代器和引用被非法化。其他引用和迭代器不受影响。
迭代器 pos
必须合法且可解引用。从而不能以 end() 迭代器(合法,但不可解引用)为 pos
的值。
若 first==last
则迭代器 first
不必可解引用:擦除空范围是无操作。
参数
pos | - | 指向要移除的元素的迭代器 |
first, last | - | 要移除的元素范围 |
返回值
后随最后移除元素的迭代器。
若 pos
指代末元素,则返回 end() 迭代器。
若在移除前 last == end()
,则返回更新的 end() 迭代器。
若 [first, last)
为空范围,则返回 last
。
异常
(无)
复杂度
1) 常数。
2) 与
first
和 last
间的距离成线性。示例
运行此代码
#include <list> #include <iostream> #include <iterator> int main( ) { std::list<int> c{0, 1, 2, 3, 4, 5, 6, 7, 8, 9}; for (auto &i : c) { std::cout << i << " "; } std::cout << '\n'; c.erase(c.begin()); for (auto &i : c) { std::cout << i << " "; } std::cout << '\n'; std::list<int>::iterator range_begin = c.begin(); std::list<int>::iterator range_end = c.begin(); std::advance(range_begin,2); std::advance(range_end,5); c.erase(range_begin, range_end); for (auto &i : c) { std::cout << i << " "; } std::cout << '\n'; }
输出:
0 1 2 3 4 5 6 7 8 9 1 2 3 4 5 6 7 8 9 1 2 6 7 8 9
参阅
清除内容 (公开成员函数) |