命名空间
变体
操作

std::deque<T,Allocator>::erase

来自 cppreference.cn
< cpp‎ | 容器‎ | deque
 
 
 
 
(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) 移除范围 [firstlast) 中的元素。

所有迭代器和引用均失效,除非被擦除的元素位于容器的末尾或开头,在这种情况下只有指向被擦除元素的迭代器和引用失效。end() 迭代器也失效,除非被擦除的元素位于容器的开头且最后一个元素未被擦除。

迭代器 pos 必须有效且可解引用。因此,end() 迭代器(有效但不可解引用)不能用作 pos 的值。

如果 first == last,则迭代器 first 无需可解引用:擦除空范围是一个无操作。

目录

[edit] 参数

pos - 指向要移除元素的迭代器
first, last - 定义要移除元素范围的迭代器对
类型要求
-
T 必须满足 可移动赋值 (MoveAssignable) 的要求。

[edit] 返回值

指向最后一个被移除元素之后的迭代器。

1) 如果 pos 指向最后一个元素,则返回 end() 迭代器。
2) 如果移除前 last == end(),则返回更新后的 end() 迭代器。
如果 [firstlast) 是一个空范围,则返回 last

[edit] 异常

除非 T 的赋值运算符抛出异常,否则不抛出。

[edit] 复杂度

线性:T 的析构函数调用次数与被擦除的元素数量相同,T 的赋值运算符调用次数不超过被擦除元素之前和之后元素数量中的较小值。

[edit] 注意

当需要根据谓词擦除容器元素时,通常使用 std::remove()/std::remove_if() 与迭代器范围重载,而不是遍历容器并调用一元 erase,以最小化剩余(未移除)元素的移动次数——这被称为擦除-移除习语。std::erase_if() 取代了擦除-移除习语。(C++20 起)

[edit] 示例

#include <deque>
#include <iostream>
 
 
void print_container(const std::deque<int>& c)
{
    for (int i : c)
        std::cout << i << ' ';
    std::cout << '\n';
}
 
int main()
{
    std::deque<int> c{0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
    print_container(c);
 
    c.erase(c.begin());
    print_container(c);
 
    c.erase(c.begin() + 2, c.begin() + 5);
    print_container(c);
 
    // Erase all even numbers
    for (std::deque<int>::iterator it = c.begin(); it != c.end();)
    {
        if (*it % 2 == 0)
            it = c.erase(it);
        else
            ++it;
    }
    print_container(c);
}

输出

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
1 7 9

缺陷报告

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

缺陷报告 应用于 发布时的行为 正确的行为
LWG 151 C++98 first 曾要求可解引用,这
使清空空 deque 的行为未定义
如果
first == last
LWG 638 C++98 尾后迭代器未失效 如果元素被从中间或末尾擦除,它会失效
从中间或末尾擦除

[edit] 参阅

擦除所有满足特定标准的元素
(函数模板) [编辑]
清除内容
(公共成员函数) [编辑]