5. erase (非メンバ関数)

最終更新日時(UTC):
が更新

履歴 編集

function template
<string>

std::erase (非メンバ関数)(C++20)

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);   // (1) C++20
  template <class CharT, class Traits, class Allocator, class U = CharT>
  constexpr typename basic_string<CharT, Traits, Allocator>::size_type
    erase(basic_string<CharT, Traits, Allocator>& c, const U& value);   // (1) C++26
}

概要

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

効果

以下と等価：

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

戻り値

削除した要素数を返す。

備考

  • (1) :
    • C++26 : 引数として波カッコ初期化{}を受け付ける 
      erase(s, {});    // ヌル文字'\0'を削除
erase(s, {'a'}); // 文字'a'を削除

例

基本的な使い方

#include <iostream>
#include <string>

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

  // コンテナsから、スペースをすべて削除する
  std::erase(s, ' ');

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

出力

HelloWorld

波カッコ初期化を入力文字として使用する (C++26)

#include <iostream>
#include <string>

int main() {
  const char ar[] = "hel\0lo";
  std::string s(ar, ar + sizeof(ar));

  std::erase(s, {});
  std::erase(s, {'l'});

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

出力

heo

バージョン

言語

  • C++20

処理系

参照