std:: basic_string

Die Klassenvorlage basic_string speichert und manipuliert Sequenzen von zeichenähnlichen Objekten, bei denen es sich um Nicht-Array-Objekte vom Typ TrivialType und StandardLayoutType handelt. Die Klasse ist weder vom Zeichentyp noch von der Art der Operationen auf diesen Typ abhängig. Die Definitionen der Operationen werden über den Traits -Template-Parameter bereitgestellt - eine Spezialisierung von std::char_traits oder eine kompatible Eigenschaftenklasse.

Die Elemente eines basic_string sind zusammenhängend gespeichert, das heißt, für einen basic_string s gilt & * ( s. begin ( ) + n ) == & * s. begin ( ) + n für jedes n in [ ​ 0 ​ , s. size ( ) ) , und * ( s. begin ( ) + s. size ( ) ) hat den Wert CharT ( ) (ein Nullterminator) (seit C++11) ; oder äquivalent dazu kann ein Zeiger auf s [ 0 ] an Funktionen übergeben werden, die einen Zeiger auf das erste Element eines Arrays (bis C++11) nullterminierten Arrays (seit C++11) von CharT erwarten.

std::basic_string erfüllt die Anforderungen von AllocatorAwareContainer (außer dass angepasste construct / destroy nicht für die Konstruktion/Destruktion von Elementen verwendet werden), SequenceContainer und ContiguousContainer (seit C++17) .

Falls einer von Traits::char_type und Allocator::value_type sich von CharT unterscheidet, ist das Programm fehlerhaft.

Es werden mehrere Typdefinitionen für gängige Zeichentypen bereitgestellt:

Template-Parameter

Verschachtelte Typen

Datenmitglieder

Memberfunktionen

Nicht-Member-Funktionen

Literale

Hilfsklassen

Deduction guides (seit C++17)

Iterator-Invalidierung

Referenzen, Zeiger und Iteratoren, die auf die Elemente eines basic_string verweisen, können durch jede Standardbibliotheksfunktion ungültig werden, die eine Referenz auf einen nicht-konstanten basic_string als Argument nimmt, wie z.B. std::getline , std::swap , oder operator>> , sowie durch den Aufruf nicht-konstanter Memberfunktionen, außer operator[] , at , data , front , back , begin , rbegin , end , und rend .

Hinweise

Obwohl es bis C++23 erforderlich war, dass benutzerdefinierte construct oder destroy verwendet werden, wenn Elemente von std::basic_string konstruiert oder zerstört werden, haben alle Implementierungen nur den Standardmechanismus verwendet. Die Anforderung wurde durch P1072R10 korrigiert, um der bestehenden Praxis zu entsprechen.

Beispiel

#include <iostream>
#include <string>
int main()
{
    using namespace std::literals;
    // Erstellen eines Strings aus const char*
    std::string str1 = "hello";
    // Erstellen eines Strings mit String-Literal
    auto str2 = "world"s;
    // Verketten von Strings
    std::string str3 = str1 + " " + str2;
    // Ausgabe des Ergebnisses
    std::cout << str3 << '\n';
    std::string::size_type pos = str3.find(" ");
    str1 = str3.substr(pos + 1); // Teil nach dem Leerzeichen
    str2 = str3.substr(0, pos);  // Teil bis zum Leerzeichen
    std::cout << str1 << ' ' << str2 << '\n';
    // Zugriff auf ein Element mit dem Indexoperator[]
    std::cout << str1[0] << '\n';
    str1[0] = 'W';
    std::cout << str1 << '\n';
}

hello world
world hello
w
World

Fehlerberichte

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

1. ↑ Der Traits::char_type Fall ist behoben in P1148R0 .

Siehe auch

Externe Links