CKTIS / C++
std::erase: usuwanie wszystkich elementów równych wartości
std::erase usuwa z obsługiwanego kontenera sekwencyjnego lub napisu wszystkie elementy równe podanej wartości i zwraca ich liczbę.
Wersja: C++23
Składnia
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) jest rodziną wolnych przeciążeń dostępną w nagłówku danego kontenera, między innymi dla vector, deque, list, forward_list i basic_string. Modyfikuje c w miejscu i zwraca size_type równy liczbie usuniętych elementów.
Dla vector, deque i napisu efekt odpowiada remove połączonemu z członkowskim erase; dla kontenerów listowych używany jest ich mechanizm usuwania. Oznacza to porównanie elementów przez ==, zachowanie względnej kolejności pozostałych oraz reguły unieważniania właściwe danemu kontenerowi.
To nie jest jeden szablon dla dowolnego zakresu: std::array ma stały rozmiar, a kontenery asocjacyjne usuwają klucz przez metodę erase. Jeśli warunek jest bardziej złożony niż równość, użyj std::erase_if. Referencja użyta jako value nie powinna wskazywać elementu kontenera, którego przesuwanie może zmienić porównywaną wartość.
Przykłady
#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';
}
Wynik
3 2 2 3
std::erase → 3 2 2 3