Namespaces
Variants

std:: erase, std:: erase_if (std::deque)

From cppreference.net

C++
Containers library
std::deque
Member types
Member functions
Non-member functions
(C++20)
erase (std::deque) erase_if (std::deque)
(C++20) (C++20)
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
定义于头文件 <deque>
(1)
template < class T, class Alloc, class U >

typename std:: deque < T, Alloc > :: size_type

erase ( std:: deque < T, Alloc > & c, const U & value ) ;
(C++20 起)
(C++26 前)
template < class T, class Alloc, class U = T >

constexpr typename std:: deque < T, Alloc > :: size_type

erase ( std:: deque < T, Alloc > & c, const U & value ) ;
(C++26 起)
template < class T, class Alloc, class Pred >

typename std:: deque < T, Alloc > :: size_type

erase_if ( std:: deque < T, Alloc > & c, Pred pred ) ;
(2) (C++20 起)
(C++26 起为 constexpr)
1) 从容器的 c 中擦除所有与 value 比较相等的元素。等价于 auto it = std :: remove ( c. begin ( ) , c. end ( ) , value ) ;
auto r = c. end ( ) - it ;
c. erase ( it, c. end ( ) ) ;
return r ; 。
2) 从容器 c 中擦除所有满足谓词 pred 的元素。等价于 auto it = std:: remove_if ( c. begin ( ) , c. end ( ) , pred ) ;
auto r = c. end ( ) - it ;
c. erase ( it, c. end ( ) ) ;
return r ; 。

目录

参数

c - 要执行擦除操作的容器
value - 待移除的数值
pred - 一元谓词，当元素应被擦除时返回​ true 。

表达式 pred ( v ) 必须可转换为 bool （对于类型 T 的每个实参 v ，无论其 值类别 为何），且不得修改 v 。因此，不允许使用 T & 作为参数类型 ，也不允许使用 T ，除非对于类型 T 移动操作等同于复制操作 (C++11 起) 。 ​

返回值

被擦除元素的数量。

复杂度

线性。

注释

功能测试 宏 值 标准 功能
__cpp_lib_algorithm_default_value_type 202403 (C++26) 列表初始化 用于 std::erase

示例

运行此代码 
#include <complex>
#include <iostream>
#include <numeric>
#include <string_view>
#include <deque>
void println(std::string_view comment, const auto& c)
{
    std::cout << comment << '[';
    bool first{true};
    for (const auto& x : c)
        std::cout << (first ? first = false, "" : ", ") << x;
    std::cout << "]\n";
}
int main()
{
    std::deque<char> cnt(10);
    std::iota(cnt.begin(), cnt.end(), '0');
    println("Initially, cnt = ", cnt);
    std::erase(cnt, '3');
    println("After erase '3', cnt = ", cnt);
    auto erased = std::erase_if(cnt, [](char x) { return (x - '0') % 2 == 0; });
    println("After erase all even numbers, cnt = ", cnt);
    std::cout << "Erased even numbers: " << erased << '\n';
    std::deque<std::complex<double>> nums{{2, 2}, {4, 2}, {4, 8}, {4, 2}};
    #ifdef __cpp_lib_algorithm_default_value_type
        std::erase(nums, {4, 2});
    #else
        std::erase(nums, std::complex<double>{4, 2});
    #endif
    println("After erase {4, 2}, nums = ", nums);
}

输出： 

Initially, cnt = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
After erase '3', cnt = [0, 1, 2, 4, 5, 6, 7, 8, 9]
After erase all even numbers, cnt = [1, 5, 7, 9]
Erased even numbers: 5
After erase {4, 2}, nums = [(2,2), (4,8)]

参见

移除满足特定条件的元素
(函数模板)
(C++20) (C++20)
移除满足特定条件的元素
(算法函数对象)