erase_if_free.md

erase_if

• string[meta header]
• std[meta namespace]
• function[meta id-type]
• cpp20[meta cpp]

namespace std {
  template <class CharT, class Traits, class Allocator, class Predicate>
  void erase_if(basic_string<CharT, Traits, Allocator>& c, Predicate pred);
}

概要

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

効果

以下と等価：

c.erase(remove_if(c.begin(), c.end(), pred), c.end());

• c.erase[link erase.md]
• remove_if[link /reference/algorithm/remove_if.md]
• c.begin()[link begin.md]
• c.end()[link end.md]

戻り値

なし

例

#include <iostream>
#include <string>

int main()
{
  std::string s = " Hello World ";

  // コンテナsから、スペースをすべて削除する
  std::erase_if(s, [](char c) { return c == ' '; });

  std::cout << s << std::endl;
}

• std::erase_if[color ff0000]

出力

HelloWorld

バージョン

言語

• C++20

処理系

• Clang: 8.0
• GCC: 9.1
• Visual C++: ??

参照

• P1209R0 | Adopt consistent container erasure from Library Fundamentals 2