Namespaces
Variants

    std::list<T,Allocator>:: remove, remove_if

    From ja.cppreference.net

    C++
    Containers library
    std::list
    Member functions
    Non-member functions
    (until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
    Deduction guides (C++17)
    (1)
    void remove ( const T & value ) ;
    		(C++20まで)
    size_type remove ( const T & value ) ;
    		(C++20から)
    (constexprはC++26から)
    (2)
    template < class UnaryPred >
    void remove_if ( UnaryPred p ) ;
    		(C++20まで)
    template < class UnaryPred >
    size_type remove_if ( UnaryPred p ) ;
    		(C++20から)
    (constexprはC++26から)

    特定の条件を満たすすべての要素を削除します。

    1) value に等しいすべての要素を削除します（ operator == を使用）。
    2) 述語 p が true を返す全ての要素を削除します。

    削除された要素に対するイテレータと参照のみを無効化します。

    目次

    パラメータ

    value - 削除する要素の値
    p - 要素が削除されるべき場合に​ true を返す単項述語。

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

    型要件
    -
    UnaryPred は Predicate の要件を満たさなければならない。

    戻り値

    (なし)

    		(until C++20)

    削除された要素の数。

    		(since C++20)

    計算量

    与えられた N を std:: distance ( begin ( ) , end ( ) ) として：

    1) 厳密に N 回の比較を operator == を使用して行う。
    2) 厳密に N 回の述語 p の適用。

    注記

    機能テスト マクロ 値 標準 機能
    __cpp_lib_list_remove_return_type 201806L (C++20) 戻り値の型を変更

    例

    このコードを実行 
    #include <list>
#include <iostream>
int main()
{
    std::list<int> l = {1, 100, 2, 3, 10, 1, 11, -1, 12};
    auto count1 = l.remove(1);
    std::cout << count1 << " elements equal to 1 were removed\n";
    auto count2 = l.remove_if([](int n){ return n > 10; });
    std::cout << count2 << " elements greater than 10 were removed\n";
    std::cout << "Finally, the list contains: ";
    for (int n : l)
        std::cout << n << ' ';
    std::cout << '\n';
}

    出力: 

    2 elements equal to 1 were removed
3 elements greater than 10 were removed
Finally, the list contains: 2 3 10 -1

    不具合報告

    以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

    DR 適用対象 公開時の動作 正しい動作
    LWG 1207 C++98 イテレータおよび/または参照が無効化されるかどうかが不明確
    		削除された要素へのイテレータと参照のみを無効化

    関連項目

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