Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::erase: apagar todos os elementos iguais a um valor

std::erase apaga de um contentor sequencial ou string suportado todos os elementos iguais ao valor e devolve quantos removeu.

Versão: C++23

Sintaxe

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) é uma família de sobrecargas livres fornecida pelo cabeçalho de cada contentor, incluindo vector, deque, list, forward_list e basic_string. Modifica c no local e devolve o número apagado como size_type do contentor.

Para vector, deque e strings, o efeito equivale a remove seguido do membro erase; contentores em lista usam o seu mecanismo. Os elementos são comparados com ==, a ordem relativa dos restantes é preservada e a invalidação segue as regras do contentor.

Não é um único template para qualquer intervalo: std::array tem tamanho fixo e contentores associativos apagam uma chave através do membro erase. Usa std::erase_if para outra condição. Evita que value referencie um elemento cuja deslocação possa mudar o valor comparado.

Exemplos

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

Resultado

3 2 2 3

std::erase → 3 2 2 3

Fontes