Namespaces
Variants

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

From 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 イテレータおよび/または参照が無効化されるかどうかが不明確
削除された要素へのイテレータと参照のみを無効化

関連項目

特定の条件を満たす要素を削除する
(関数テンプレート)