Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje