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

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Bibliothek für Zeichenketten

Klassen

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Memberfunktionen basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator Elementzugriff basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Iteratoren basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Suche 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

Modifizierer basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap Kapazität basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Operationen basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

Konstanten basic_string::npos Nicht-Member-Funktionen operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline Vergleich operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) Numerische Konvertierungen stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Literale operator""s (C++14) Hilfsklassen hash<std::basic_string> (C++11) Deduction guides (C++17)

 

basic_string& erase( size_type index = 0, size_type count = npos );	(1)	(constexpr seit C++20)
	(2)
iterator erase( iterator position );			(bis C++11)
iterator erase( const_iterator position );			(seit C++11) (constexpr seit C++20)
		(3)
iterator erase( iterator first, iterator last );				(bis C++11)
iterator erase( const_iterator first, const_iterator last );				(seit C++11) (constexpr seit C++20)

Entfernt angegebene Zeichen aus dem String.

1) Entfernt std::min(count, size() - index) Zeichen, beginnend bei index.

2) Entfernt das Zeichen an position.

Wenn position kein dereferenzierbarer Iterator auf *this ist, ist das Verhalten undefiniert.

3) Entfernt die Zeichen im Bereich [first, last).

Wenn first oder last kein gültiger Iterator auf *this ist oder [first, last) kein gültiger Bereich ist, ist das Verhalten undefiniert.

Parameter

index	-	Erstes zu entfernendes Zeichen
zählt	-	Anzahl der zu entfernenden Zeichen
position	-	Iterator auf das zu entfernende Zeichen
first, last	-	Bereich der zu entfernenden Zeichen

Rückgabewert

1) *this

2) Iterator, der auf das Zeichen unmittelbar nach dem entfernten Zeichen zeigt, oder end(), falls kein solches Zeichen existiert.

3) Iterator, der auf das Zeichen zeigt, auf das last vor dem Löschen gezeigt hat, oder end(), falls kein solches Zeichen existiert.

Ausnahmen

1) std::out_of_range, wenn index > size().

2,3) Wirft nichts.

Wenn aus irgendeinem Grund eine Ausnahme ausgelöst wird, hat diese Funktion keine Auswirkungen (starkes Ausnahmesicherheitsgarantie).

Beispiel

Führen Sie diesen Code aus

#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); // erases " An" using overload (1)
    std::cout << "2) " << s << '\n';
 
    s.erase(std::find(s.begin(), s.end(), ' ')); // erases first ' '; overload (2)
    std::cout << "3) " << s << '\n';
 
    s.erase(s.find(' ')); // trims from ' ' to the end of the string; overload (1)
    std::cout << "4) " << s << '\n';
 
    auto it = std::next(s.begin(), s.find('s')); // obtains iterator to the first 's'
    s.erase(it, std::next(it, 2)); // erases "sI"; overload (3)
    std::cout << "5) " << s << '\n';
}

Ausgabe

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

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 27	C++98	Überladung (3) hat das Zeichen, auf das last gezeigt hat, nicht gelöscht, sondern sie hat zurückgegeben den Iterator, der auf das Zeichen unmittelbar nach diesem Zeichen zeigt	Gibt einen Iterator zurück. auf dieses Zeichen zeigt
LWG 428	C++98	Überladung (2) erforderte explizit, dass position gültig ist, aber SequenceContainer erfordert, dass er dereferenzierbar ist (strenger)	entfernte die explizite Anforderung
LWG 847	C++98	Es gab keine Ausnahmesicherheitsgarantie	starke Ausnahme hinzugefügt Garantie der Sicherheit

Siehe auch

clear

leert den Inhalt (öffentliche Memberfunktion)