最終更新日時(UTC): 2026年02月17日 14時22分33秒
Akira Takahashi が更新

履歴 編集

function template
<set>

# std::erase_if(C++20)

    namespace std {
      template <class Key, class Compare, class Allocator, class Predicate>
      typename multiset<Key, Compare, Allocator>::size_type
        erase_if(multiset<Key, Compare, Allocator>& c, Predicate pred); // (1) C++20
      template <class Key, class Compare, class Allocator, class Predicate>
      constexpr typename multiset<Key, Compare, Allocator>::size_type
        erase_if(multiset<Key, Compare, Allocator>& c, Predicate pred); // (1) C++26
    }

## 概要

指定した条件に合致する要素とその分の領域を、コンテナから削除する。

## 効果

以下と等価：

    auto original_size = c.size();
    for (auto i = c.begin(), last = c.end(); i != last;) {
      if (pred(*i)) {
        i = c.erase(i);
      } else {
        ++i;
      }
    }
    return original_size - c.size();

## 戻り値

削除した要素数を返す。

## 例

    #include <iostream>
    #include <set>

    int main()
    {
      std::multiset<int> s = {3, 1, 4, 1};

      // コンテナsから、キー1をもつ要素をすべて削除する
      std::erase_if(s, [](int x) { return x == 1; });

      for (int x : s) {
        std::cout << x << std::endl;
      }
    }

### 出力

    3
    4

## バージョン

### 言語

- C++20

### 処理系

- Clang: 8.0 ✅
- GCC: 9.1 ✅
- Visual C++: ??

## 参照

- P1209R0 Adopt consistent container erasure from Library Fundamentals 2
- R1115R3 Improving the Return Value of Erase-Like Algorithms II: Free `erase`/`erase_if`
- P3372R3 constexpr containers and adaptors