std::basic_string::erase

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Strings library
Narrow character strings Wide character strings Classes basic_string char_traits
std::basic_string
Member functions basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Element access basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str Iterators basic_string::begin basic_string::cbegin (C++11) basic_string::end basic_string::cend (C++11) basic_string::rbegin basic_string::crbegin (C++11) basic_string::rend basic_string::crend (C++11) Capacity basic_string::empty basic_string::size basic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11) Operations basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Search basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constants basic_string::npos Non-member functions getline stoi stol stoll (C++11) (C++11) (C++11) stoul stoull (C++11) (C++11) stof stod stold (C++11) (C++11) (C++11) to_string (C++11) to_wstring (C++11)

basic_string& erase(size_type index = 0, size_type count = npos);	(1)
iterator erase( iterator position ); iterator erase( const_iterator position );	(2)	(pre-C++11 version) (C++11 version)
iterator erase( iterator first, iterator last ); iterator erase( const_iterator first, const_iterator last );	(3)	(pre-C++11 version) (C++11 version)

Removes specified characters from the string.

1) Removes count characters starting at index.

2) Removes the character at pos.

3) Removes the character in the range [first; last).

This section is incomplete Reason: exceptions

Contents 1 Parameters 2 Return value 3 Complexity 4 See also

[edit] Parameters

index	-	first character to remove
count	-	number of characters to remove
pos	-	iterator to the character to remove
first, last	-	range of the characters to remove

[edit] Return value

1) *this

2-3) iterator following the last removed character.

[edit] Complexity

1) linear in count.

2) Constant.

3) linear in distance between first and last.

[edit] See also

clear	clears the contents (public member function)