KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::erase_if: elementen wissen die aan een predicaat voldoen

std::erase_if test elementen van een ondersteunde container, wist die waarvoor het predicaat true is en retourneert het aantal.

Versie: C++23

Syntax

template<class Key, class T, class Compare, class Allocator, class Predicate>
typename std::map<Key, T, Compare, Allocator>::size_type
erase_if(std::map<Key, T, Compare, Allocator>& c, Predicate pred);
// Corresponding overloads exist for other supported containers.

std::erase_if(c, pred) is een familie overloads in containerheaders. Ze omvat sequenties en strings plus geordende, ongeordende en vlakke associatieve C++23-containers. std::array, waarvan de grootte niet verandert, wordt niet ondersteund.

Bij vector, deque en strings is het effect gelijk aan remove_if plus lid erase. Gewone geordende en ongeordende maps en sets evalueren pred(*it); C++23-flat_map en flat_multimap geven in plaats daarvan pair<const Key&, const T&> door. Het resultaat is size_type, geen iterator.

Het predicaat moet stabiel zijn voor het onderzochte element en mag de iteratie niet ongeldig maken door dezelfde container zelf te wijzigen. Uitzonderingsgaranties, invalidatie en complexiteit zijn overloadspecifiek; een uitzondering uit het predicaat kan de container gedeeltelijk gewijzigd achterlaten.

Voorbeelden

#include <iostream>
#include <map>

int main() {
    std::map<int, int> values{{1, 10}, {2, 20}, {3, 30}};
    const auto removed = std::erase_if(values, [](const auto& item) {
        return item.first % 2 != 0;
    });
    std::cout << removed << ' ' << values.size() << ' ' << values.begin()->first << '\n';
}

Resultaat

2 1 2

std::erase_if → 2 1 2

Bronnen