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