namespace std {
template <class T, class Allocator, class U>
typename deque<T, Allocator>::size_type
erase(deque<T, Allocator>& c, const U& value); // (1) C++20
template <class T, class Allocator, class U = T>
typename deque<T, Allocator>::size_type
erase(deque<T, 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 : 引数として波カッコ初期化
{}
を受け付ける
std::deque<std::vector<int>> d; erase(d, {}); // 空の要素を削除 erase(d, {1, 2, 3}); // 値{1, 2, 3}をもつ要素を削除
- C++26 : 引数として波カッコ初期化
例
基本的な使い方
#include <iostream>
#include <deque>
int main()
{
std::deque<int> deq = {3, 1, 4, 1, 5};
// コンテナdeqから、値1をもつ要素をすべて削除する
std::erase(deq, 1);
for (int x : deq) {
std::cout << x << std::endl;
}
}
出力
3
4
5
波カッコ初期化を入力として使用する (C++26)
#include <print>
#include <deque>
#include <vector>
int main() {
std::deque<std::vector<int>> d = {
{1, 2, 3},
{4, 5, 6},
{},
{7, 8}
};
std::erase(d, {}); // 空の要素を削除
std::erase(d, {1, 2, 3}); // 値{1, 2, 3}をもつ要素を削除
std::println("{}", d);
}
出力
[[4, 5, 6], [7, 8]]
バージョン
言語
- C++20
処理系
- Clang: 8.0 ✅
- GCC: 9.1 ✅
- Visual C++: ??