Namespaces
Variants

std:: erase, std:: erase_if (std::list)

From cppreference.net

C++
Containers library
std::list
Member functions
Non-member functions
(C++20)
erase (std::list) erase_if (std::list)
(C++20) (C++20)
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
ヘッダーで定義 <list>
(1)
template < class T, class Alloc, class U >

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

erase ( std:: list < T, Alloc > & c, const U & value ) ;
(C++20以降)
(C++26まで)
template < class T, class Alloc, class U = T >

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

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

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

erase_if ( std:: list < T, Alloc > & c, Pred pred ) ;
(2) (C++20以降)
(C++26以降constexpr)
1) コンテナ c から value と等しい比較結果となる全ての要素を削除します。 return c. remove_if ( [ & ] ( const auto & elem ) - > bool { return elem == value ; } ) ; と等価です。
2) コンテナ c から述語 pred を満たすすべての要素を削除します。 return c. remove_if ( pred ) ; と等価です。

目次

パラメータ

c - 要素を削除するコンテナ
value - 削除する値
pred - 要素が削除されるべき場合に​ true を返す単項述語。

式 pred ( v ) は、 v の型（const修飾可能性あり）が T であるすべての引数について、 値カテゴリ に関わらず bool に変換可能でなければならず、 v を変更してはならない。したがって、 T & のパラメータ型は許可されない 。また T も、 T においてムーブがコピーと等価である場合を除き許可されない (C++11以降) 。 ​

戻り値

削除された要素の数。

計算量

線形。

注記

std::list::remove とは異なり、 erase は異種型を受け入れ、コンテナの値型への変換を強制せずに == 演算子を呼び出します。

機能テスト マクロ 値 標準 機能
__cpp_lib_algorithm_default_value_type 202403 (C++26) リスト初期化 による std::erase

例

このコードを実行 
#include <complex>
#include <iostream>
#include <numeric>
#include <string_view>
#include <list>
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::list<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::list<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++規格に対して遡及的に適用されました。

DR 適用対象 公開時の動作 正しい動作
LWG 4135 C++20 ラムダ述語の戻り値型が
述語の引数から推論されていた 		戻り値型は
明示的に bool と指定される

関連項目

特定の条件を満たす要素を削除する
(関数テンプレート)
(C++20) (C++20)
特定の条件を満たす要素を削除する
(アルゴリズム関数オブジェクト)
特定の条件を満たす要素を削除する
(公開メンバ関数)