CKTIS / C++
std::erase: odstranění všech prvků rovných hodnotě
std::erase odstraní z podporovaného sekvenčního kontejneru nebo řetězce všechny prvky rovné hodnotě a vrátí jejich počet.
Verze: C++23
Syntaxe
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) je rodina volných přetížení z hlavičky příslušného kontejneru, mimo jiné pro vector, deque, list, forward_list a basic_string. Změní c na místě a vrátí počet smazaných prvků jako size_type.
Pro vector, deque a řetězce je účinek ekvivalentní remove následovanému členem erase; seznamy používají vlastní mechanismus. Prvky se porovnávají pomocí ==, relativní pořadí zbylých se zachová a zneplatnění se řídí pravidly kontejneru.
Nejde o jedinou šablonu pro každý rozsah: std::array má pevnou velikost a asociativní kontejnery mažou klíč členem erase. Pro jinou podmínku použij std::erase_if. value nemá odkazovat na prvek, jehož přesun může změnit porovnávanou hodnotu.
Příklady
#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';
}
Výsledek
3 2 2 3
std::erase → 3 2 2 3