Namespaces
Variants

    std::basic_string<CharT,Traits,Allocator>::erase

    From ru.cppreference.net
     
    C++
     
    Strings library
     
    std::basic_string
     
    basic_string& erase( size_type index = 0, size_type count = npos );
    		(1) (constexpr since C++20) 
    iterator erase( iterator position );
    		(2) (until C++11) 
    iterator erase( const_iterator position );
    		(since C++11)
    (constexpr since C++20)    		 
    iterator erase( iterator first, iterator last );
    		(3) (until C++11) 
    iterator erase( const_iterator first, const_iterator last );
    		(since C++11)
    (constexpr since C++20)

    Удаляет указанные символы из строки.

    1) Удаляет std::min(count, size() - index) символов, начиная с index.
    2) Удаляет символ по итератору position.
    Если position не является разыменовываемым итератором для *this, поведение не определено.
    3) Удаляет символы в диапазоне [first, last).
    Если first или last не является валидным итератором для *this, или [first, last) не является валидным диапазоном, поведение не определено.

    Параметры

    index - первый символ для удаления
    count - количество символов для удаления
    position - итератор на удаляемый символ
    first, last - диапазон символов для удаления

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

    1) * this
    2) Итератор, указывающий на символ, следующий непосредственно за удалённым символом, или end() если такого символа не существует.
    3) Итератор, указывающий на символ last , на который указывал до стирания, или end() , если такого символа не существует.

    Исключения

    1) std::out_of_range если index > size ( ) .
    2,3) Ничего не выбрасывает.

    Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).

    Пример

    Запустить этот код 
    #include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::string s = "This Is An Example";
    std::cout << "1) " << s << '\n';
    s.erase(7, 3); // удаляет " An" используя перегрузку (1)
    std::cout << "2) " << s << '\n';
    s.erase(std::find(s.begin(), s.end(), ' ')); // удаляет первый пробел; перегрузка (2)
    std::cout << "3) " << s << '\n';
    s.erase(s.find(' ')); // обрезает от пробела до конца строки; перегрузка (1)
    std::cout << "4) " << s << '\n';
    auto it = std::next(s.begin(), s.find('s')); // получает итератор на первую 's'
    s.erase(it, std::next(it, 2)); // удаляет "sI"; перегрузка (3)
    std::cout << "5) " << s << '\n';
}

    Вывод: 

    1) This Is An Example
2) This Is Example
3) ThisIs Example
4) ThisIs
5) This

    Отчеты о дефектах

    Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

    DR Применяется к Поведение в опубликованной версии Исправленное поведение
    LWG 27 C++98 перегрузка ( 3 ) не удаляла символ last , но возвращала
    итератор, указывающий на символ сразу после этого символа     		возвращает итератор
    , указывающий на этот символ
    LWG 428 C++98 перегрузка ( 2 ) явно требовала, чтобы position был действительным, но
    SequenceContainer требует, чтобы он был разыменовываемым (строже)     		удалено явное
    требование
    LWG 847 C++98 не было гарантии безопасности исключений добавлена строгая гарантия
    безопасности исключений

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

    		очищает содержимое
    (публичная функция-член)