Namespaces
Variants

    std::list<T,Allocator>:: remove, remove_if

    From es.cppreference.net

    C++
    Containers library
    std::list
    Member functions
    Non-member functions
    (until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
    Deduction guides (C++17)
    (1)
    void remove ( const T & value ) ;
    		(hasta C++20)
    size_type remove ( const T & value ) ;
    		(desde C++20)
    (constexpr desde C++26)
    (2)
    template < class UnaryPred >
    void remove_if ( UnaryPred p ) ;
    		(hasta C++20)
    template < class UnaryPred >
    size_type remove_if ( UnaryPred p ) ;
    		(desde C++20)
    (constexpr desde C++26)

    Elimina todos los elementos que cumplen criterios específicos.

    1) Elimina todos los elementos que son iguales a value (usando operator == ).
    2) Elimina todos los elementos para los cuales el predicado p devuelve true .

    Invalida únicamente los iteradores y referencias a los elementos eliminados.

    Contenido

    Parámetros

    value - valor de los elementos a eliminar
    p - predicado unario que devuelve ​ true si el elemento debe eliminarse.

    La expresión p ( v ) debe ser convertible a bool para cada argumento v de tipo (posiblemente const) T , independientemente de la categoría de valor , y no debe modificar v . Por lo tanto, no se permite un tipo de parámetro T & , ni tampoco T a menos que para T un movimiento sea equivalente a una copia (since C++11) . ​

    Requisitos de tipo
    -
    UnaryPred debe cumplir con los requisitos de Predicate .

    Valor de retorno

    (ninguno)

    		(until C++20)

    El número de elementos eliminados.

    		(since C++20)

    Complejidad

    Dado N como std:: distance ( begin ( ) , end ( ) ) :

    1) Exactamente N comparaciones usando operator == .
    2) Exactamente N aplicaciones del predicado p .

    Notas

    Macro de prueba de características Valor Std Característica
    __cpp_lib_list_remove_return_type 201806L (C++20) Cambiar el tipo de retorno

    Ejemplo

    Ejecutar este código 
    #include <list>
#include <iostream>
int main()
{
    std::list<int> l = {1, 100, 2, 3, 10, 1, 11, -1, 12};
    auto count1 = l.remove(1);
    std::cout << count1 << " elements equal to 1 were removed\n";
    auto count2 = l.remove_if([](int n){ return n > 10; });
    std::cout << count2 << " elements greater than 10 were removed\n";
    std::cout << "Finally, the list contains: ";
    for (int n : l)
        std::cout << n << ' ';
    std::cout << '\n';
}

    Salida: 

    2 elements equal to 1 were removed
3 elements greater than 10 were removed
Finally, the list contains: 2 3 10 -1

    Informes de defectos

    Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

    DR Aplicado a Comportamiento publicado Comportamiento correcto
    LWG 1207 C++98 no estaba claro si los iteradores
    y/o referencias serían invalidados     		solo invalida iteradores y
    referencias a los elementos eliminados

    Véase también

    		 elimina elementos que satisfacen criterios específicos
    (plantilla de función & objeto función de algoritmo)
    (C++20)(C++20)