erase_free.md

erase (非メンバ関数)

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

namespace std {
  template <class CharT, class Traits, class Allocator, class U>
  constexpr typename basic_string<CharT, Traits, Allocator>::size_type
    erase(basic_string<CharT, Traits, Allocator>& c, const U& value);
}

概要

指定した値をもつ要素とその分の領域を、コンテナから削除する。

効果

以下と等価：

auto it = remove(c.begin(), c.end(), value);
auto r = distance(it, c.end());
c.erase(it, c.end());
return r;

• c.erase[link erase.md]
• remove[link /reference/algorithm/remove.md]
• distance[link /reference/iterator/distance.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(s, ' ');

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

• std::erase[color ff0000]

出力

HelloWorld

バージョン

言語

• C++20

処理系

• Clang: 8.0 [mark verified]
• GCC: 9.1 [mark verified]
• 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