# std::erase, std::erase_if (std::list)

From cppreference.com
< cpp‎ | container‎ | list

Defined in header `<list>` |  |
template< class T, class Alloc, class U > void erase(std::list<T,Alloc>& c, const U& value); | (1) | (since C++20)
template< class T, class Alloc, class Pred > void erase_if(std::list<T,Alloc>& c, Pred pred); | (2) | (since C++20)

1) Erases all elements that compare equal to `value` from the container. Equivalent to c.remove_if([&](auto& elem) { return elem == value; });
2) Erases all elements that satisfy the predicate `pred` from the container. Equivalent to c.remove_if(pred);

### Parameters

c | - | container from which to erase
value | - | value to be removed
pred | - | unary predicate which returns ​true if the element should be erased. The expression pred(v) must be convertible to bool for every argument `v` of type (possibly const) `T`, regardless of value category, and must not modify `v`. Thus, a parameter type of T&is not allowed, nor is T unless for `T` a move is equivalent to a copy (since C++11). ​

### Complexity

Linear.

### Example

| This section is incomplete Reason: no example

### Notes

Unlike std::list::remove, `erase` accepts heterogenous types and does not force a conversion to the container's value type before invoking the == operator.

### See also

remove remove_if | removes elements satisfying specific criteria (function template)
remove remove_if | removes elements satisfying specific criteria (public member function)

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/container/list/erase2&oldid=108079"