Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::erase: odstránenie všetkých prvkov rovných hodnote

std::erase odstráni z podporovaného sekvenčného kontajnera alebo reťazca všetky prvky rovné hodnote a vráti ich počet.

Verzia: 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) je rodina voľných preťažení z hlavičky príslušného kontajnera, okrem iného pre vector, deque, list, forward_list a basic_string. Zmení c na mieste a vráti počet zmazaných prvkov ako size_type.

Pre vector, deque a reťazce je účinok ekvivalentný remove nasledovanému členom erase; zoznamy používajú vlastný mechanizmus. Prvky sa porovnávajú pomocou ==, relatívne poradie zvyšných sa zachová a zneplatnenie sa riadi pravidlami kontajnera.

Nejde o jedinú šablónu pre každý rozsah: std::array má pevnú veľkosť a asociatívne kontajnery mažú kľúč členom erase. Pre inú podmienku použi std::erase_if. value nemá odkazovať na prvok, ktorého presun môže zmeniť porovnávanú hodnotu.

Prí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ýsledok

3 2 2 3

std::erase → 3 2 2 3

Zdroje