WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::erase: alle zu einem Wert gleichen Elemente löschen

std::erase entfernt aus einem unterstützten Sequenzcontainer oder String alle zum Wert gleichen Elemente und liefert deren Anzahl.

Version: C++23

Syntax

template<class T, class Allocator, class U>
constexpr typename std::vector<T, Allocator>::size_type
erase(std::vector<T, Allocator>& c, const U& value);
// Corresponding overloads exist for other supported sequence containers and basic_string.

std::erase(c, value) ist eine Familie freier Overloads im jeweiligen Container-Header, unter anderem für vector, deque, list, forward_list und basic_string. Die Funktion ändert c direkt und liefert die Zahl gelöschter Elemente als size_type.

Bei vector, deque und Strings entspricht die Wirkung remove gefolgt vom Member erase; Listencontainer nutzen ihren Löschmechanismus. Verglichen wird mit ==, die relative Reihenfolge verbleibender Elemente bleibt erhalten und die Invalidierung folgt den Erase-Regeln des Containers.

Dies ist kein einzelnes Template für jeden Bereich: std::array hat feste Größe, assoziative Container löschen Schlüssel mit ihrem Member erase. Für eine andere Bedingung als Gleichheit dient std::erase_if. value sollte nicht auf ein Containerelement verweisen, dessen Verschiebung den Vergleichswert ändern kann.

Beispiele

#include <iostream>
#include <vector>

int main() {
    std::vector<int> values{1, 2, 1, 3, 1};
    const auto removed = std::erase(values, 1);
    std::cout << removed << ' ' << values.size();
    for (int value : values) std::cout << ' ' << value;
    std::cout << '\n';
}

Ergebnis

3 2 2 3

std::erase → 3 2 2 3

Quellen