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

CKTIS / C++

std::erase_if: odstranění prvků splňujících predikát

std::erase_if otestuje prvky podporovaného kontejneru, odstraní ty s predikátem true a vrátí jejich počet.

Verze: C++23

Syntaxe

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) je rodina přetížení v hlavičkách kontejnerů. Zahrnuje sekvence a řetězce i uspořádané, neuspořádané a ploché asociativní kontejnery C++23. Nezahrnuje std::array, jehož velikost nelze měnit.

Pro vector, deque a řetězce je účinek ekvivalentní remove_if a členu erase. Běžné uspořádané i neuspořádané mapy a množiny vyhodnocují pred(*it); C++23 flat_map a flat_multimap místo toho předají pair<const Key&, const T&>. Výsledkem je size_type, nikoli iterátor.

Predikát má být pro zkoumaný prvek stabilní a nesmí zneplatnit průchod samostatnou změnou téhož kontejneru. Záruky výjimek, zneplatnění iterátorů a složitost závisejí na přetížení; výjimka predikátu může ponechat kontejner částečně změněný.

Příklady

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

Výsledek

2 1 2

std::erase_if → 2 1 2

Zdroje