Namespaces
Variants

std:: erase, std:: erase_if (std::inplace_vector)

From cppreference.net

C++
Containers library
std::inplace_vector
Member types
Member functions
Non-member functions
erase (std::inplace_vector) erase_if (std::inplace_vector)
定義先ヘッダ <inplace_vector>
template < class T, std:: size_t N, class U = T >

constexpr typename std:: inplace_vector < T, N > :: size_type

erase ( std:: inplace_vector < T, N > & c, const U & value ) ;
(1) (C++26以降)
template < class T, std:: size_t N, class Pred >

constexpr typename std:: inplace_vector < T, N > :: size_type

erase_if ( std:: inplace_vector < T, N > & c, Pred pred ) ;
(2) (C++26以降)
1) コンテナ c から value と等しい比較を行うすべての要素を削除します。以下と等価です： auto it = std :: remove ( c. begin ( ) , c. end ( ) , value ) ;
auto r = std:: distance ( it, c. end ( ) ) ;
c. erase ( it, c. end ( ) ) ;
return r ; .
2) コンテナ c から述語 pred を満たす全ての要素を削除します。以下と等価です： auto it = std:: remove_if ( c. begin ( ) , c. end ( ) , pred ) ;
auto r = std:: distance ( it, c. end ( ) ) ;
c. erase ( it, c. end ( ) ) ;
return r ; 。

目次

パラメータ

c - 削除元のコンテナ
value - 削除する値
pred - 要素が削除されるべき場合に​ true を返す単項述語。

式 pred ( v ) は、 v の型（const修飾可能性あり）が T であるすべての引数について、 値カテゴリ に関わらず bool に変換可能でなければならず、 v を変更してはならない。したがって、 T & のパラメータ型は許可されない 。また、 T について移動がコピーと等価でない限り、 T も同様に許可されない (C++11以降) 。 ​

戻り値

削除された要素の数。

計算量

線形。

例

このコードを実行 
#include <cassert>
#include <complex>
#include <inplace_vector>
#include <numeric>
#include <print>
int main()
{
    std::inplace_vector<int, 10> v(10, 0);
    std::ranges::iota(v, 0);
    std::println("Initially, v = {}", v);
    auto erased = std::erase(v, 3);
    std::println("After erase(v, 3), v = {}", v);
    assert(erased == 1);
    erased = std::erase_if(v, [](int x) { return x % 2 == 0; });
    std::println("After erasing all even numbers, v = {}", v);
    std::println("Erased even numbers: {}", erased);
    std::inplace_vector<std::complex<double>> nums{{2, 2}, {4, 2}, {4, 8}, {4, 2}};
    std::erase(nums, {4, 2}); // since U = T, the value type can be ommited
    std::println("After erase {4, 2}, nums = {}", nums);
}

出力: 

Initially, v = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
After erase(v, 3), v = [0, 1, 2, 4, 5, 6, 7, 8, 9]
After erasing all even numbers, v = [1, 5, 7, 9]
Erased even numbers: 5
After erase {4, 2}, nums = [(2,2), (4,8)]

関連項目

特定の条件を満たす要素を削除する
(関数テンプレート)
(C++20) (C++20)
特定の条件を満たす要素を削除する
(アルゴリズム関数オブジェクト)