KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::erase: alle elementen gelijk aan een waarde wissen

std::erase wist uit een ondersteunde sequentiecontainer of string alle elementen die gelijk zijn aan de waarde en retourneert hun aantal.

Versie: 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) is een familie vrije overloads uit de header van de container, onder meer voor vector, deque, list, forward_list en basic_string. Ze wijzigt c ter plaatse en retourneert het aantal gewiste elementen als size_type.

Voor vector, deque en strings is het effect gelijk aan remove gevolgd door lid erase; lijstcontainers gebruiken hun verwijderingsmechanisme. Elementen worden met == vergeleken, de relatieve volgorde van overblijvers blijft en invalidatie volgt de containerregels.

Dit is niet één template voor elk bereik: std::array heeft een vaste grootte en associatieve containers wissen een sleutel via hun lid erase. Gebruik std::erase_if voor een andere voorwaarde. Laat value niet verwijzen naar een element waarvan verplaatsing de vergeleken waarde kan wijzigen.

Voorbeelden

#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';
}

Resultaat

3 2 2 3

std::erase → 3 2 2 3

Bronnen