Namespaces
Variants

std:: erase, std:: erase_if (std::forward_list)

From cppreference.net

C++
Containers library
std::forward_list
Member functions
Non-member functions
(C++20)
erase (std::forward_list) erase_if (std::forward_list)
(C++20) (C++20)
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
Definiert in Header <forward_list>
(1)
template < class T, class Alloc, class U >

typename std:: forward_list < T, Alloc > :: size_type

erase ( std:: forward_list < T, Alloc > & c, const U & value ) ;
(seit C++20)
(bis C++26)
template < class T, class Alloc, class U = T >

constexpr typename std:: forward_list < T, Alloc > :: size_type

erase ( std:: forward_list < T, Alloc > & c, const U & value ) ;
(seit C++26)
template < class T, class Alloc, class Pred >

typename std:: forward_list < T, Alloc > :: size_type

erase_if ( std:: forward_list < T, Alloc > & c, Pred pred ) ;
(2) (seit C++20)
(constexpr seit C++26)
1) Löscht alle Elemente, die gleich value sind, aus dem Container c . Entspricht return c. remove_if ( [ & ] ( const auto & elem ) - > bool { return elem == value ; } ) ; .
2) Löscht alle Elemente, die das Prädikat pred erfüllen, aus dem Container c . Entspricht return c. remove_if ( pred ) ; .

Inhaltsverzeichnis

Parameter

c - Container, aus dem gelöscht werden soll
value - zu entfernender Wert
pred - unäres Prädikat, das ​ true zurückgibt, wenn das Element gelöscht werden soll.

Der Ausdruck pred ( v ) muss für jedes Argument v vom Typ (möglicherweise const) T unabhängig vom Wertkategorie in bool konvertierbar sein und darf v nicht modifizieren. Daher ist ein Parametertyp T & nicht zulässig , ebenso wenig wie T , es sei denn, für T ist eine Verschiebung äquivalent zu einer Kopie (seit C++11) . ​

Rückgabewert

Die Anzahl der gelöschten Elemente.

Komplexität

Linear.

Hinweise

Im Gegensatz zu std::forward_list::remove akzeptiert erase heterogene Typen und erzwingt keine Konvertierung in den Werttyp des Containers, bevor der == -Operator aufgerufen wird.

Feature-Test Makro Wert Std Funktion
__cpp_lib_algorithm_default_value_type 202403 (C++26) Listeninitialisierung für std::erase

Beispiel

Diesen Code ausführen 
#include <complex>
#include <iostream>
#include <numeric>
#include <string_view>
#include <forward_list>
void println(std::string_view comment, const auto& c)
{
    std::cout << comment << '[';
    bool first{true};
    for (const auto& x : c)
        std::cout << (first ? first = false, "" : ", ") << x;
    std::cout << "]\n";
}
int main()
{
    std::forward_list<char> cnt(10);
    std::iota(cnt.begin(), cnt.end(), '0');
    println("Initially, cnt = ", cnt);
    std::erase(cnt, '3');
    println("After erase '3', cnt = ", cnt);
    auto erased = std::erase_if(cnt, [](char x) { return (x - '0') % 2 == 0; });
    println("After erase all even numbers, cnt = ", cnt);
    std::cout << "Erased even numbers: " << erased << '\n';
    std::forward_list<std::complex<double>> nums{{2, 2}, {4, 2}, {4, 8}, {4, 2}};
    #ifdef __cpp_lib_algorithm_default_value_type
        std::erase(nums, {4, 2});
    #else
        std::erase(nums, std::complex<double>{4, 2});
    #endif
    println("After erase {4, 2}, nums = ", nums);
}

Ausgabe: 

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

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 4135 C++20 der Rückgabetyp des verwendeten Lambda-Prädikats
wurde aus Prädikat-Argumenten abgeleitet 		der Rückgabetyp ist
explizit als bool spezifiziert

Siehe auch

Entfernt Elemente, die bestimmte Kriterien erfüllen
(Funktions-Template)
(C++20) (C++20)
Entfernt Elemente, die bestimmte Kriterien erfüllen
(Algorithmus-Funktionsobjekt)
Entfernt Elemente, die bestimmte Kriterien erfüllen
(Öffentliche Elementfunktion)