Namespaces
Variants

std:: erase, std:: erase_if (std::basic_string)

From cppreference.net

C++
Strings library
std::basic_string
Определено в заголовке <string>
(1)
template < class CharT, class Traits, class Alloc, class U >

constexpr typename std:: basic_string < CharT, Traits, Alloc > :: size_type

erase ( std:: basic_string < CharT, Traits, Alloc > & c, const U & value ) ;
(начиная с C++20)
(до C++26)
template < class CharT, class Traits, class Alloc, class U = CharT >

constexpr typename std:: basic_string < CharT, Traits, Alloc > :: size_type

erase ( std:: basic_string < CharT, Traits, Alloc > & c, const U & value ) ;
(начиная с C++26)
template < class CharT, class Traits, class Alloc, class Pred >

constexpr typename std:: basic_string < CharT, Traits, Alloc > :: size_type

erase_if ( std:: basic_string < CharT, Traits, Alloc > & c, Pred pred ) ;
(2) (начиная с C++20)
1) Удаляет все элементы, равные value из контейнера c . Эквивалентно auto it = std :: remove ( c. begin ( ) , c. end ( ) , value ) ;
auto r = c. end ( ) - it ;
c. erase ( it, c. end ( ) ) ;
return r ; .
2) Удаляет все элементы, удовлетворяющие предикату pred из контейнера c . Эквивалентно auto it = std:: remove_if ( c. begin ( ) , c. end ( ) , pred ) ;
auto r = c. end ( ) - it ;
c. erase ( it, c. end ( ) ) ;
return r ; .

Содержание

Параметры

c - контейнер, из которого производится удаление
value - значение для удаления
pred - унарный предикат, возвращающий ​ true если элемент должен быть удалён.

Выражение pred ( v ) должно быть преобразуемо в bool для любого аргумента v типа (возможно const) CharT , независимо от категории значения , и не должно изменять v . Следовательно, параметр типа CharT & не допускается , как и CharT , если для CharT перемещение не эквивалентно копированию (since C++11) . ​

Возвращаемое значение

Количество удалённых элементов.

Сложность

Линейный.

Примечания

Макрос тестирования возможностей Значение Стандарт Возможность
__cpp_lib_algorithm_default_value_type 202403 (C++26) Списковая инициализация для std::erase

Пример

Запустить этот код 
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::string word{"startling"};
    std::cout << "Initially, word = " << std::quoted(word) << '\n';
    std::erase(word, 'l');
    std::cout << "After erase 'l': " << std::quoted(word) << '\n';
    auto erased = std::erase_if(word, [](char x)
    {
        return x == 'a' or x == 'r' or x == 't';
    });
    std::cout << "After erase all 'a', 'r', and 't': " << std::quoted(word) << '\n';
    std::cout << "Erased symbols count: " << erased << '\n';
#if __cpp_lib_algorithm_default_value_type
    std::erase(word, {'g'});
    std::cout << "After erase {'g'}: " << std::quoted(word) << '\n';
#endif
}

Возможный вывод: 

Initially, word = "startling"
After erase 'l', word = "starting"
After erase all 'a', 'r', and 't': "sing"
Erased symbols count: 4
After erase {'g'}: "sin"

Смотрите также

удаляет элементы, удовлетворяющие определенным критериям
(шаблон функции)
(C++20) (C++20)
удаляет элементы, удовлетворяющие определенным критериям
(функциональный объект алгоритма)