std::basic_string

template<
    class CharT,
    class Traits = std::char_traits<CharT>,
    class Allocator = std::allocator<CharT>
> class basic_string;

namespace pmr {
template<
    class CharT,
    class Traits = std::char_traits<CharT>
> using basic_string =
    std::basic_string<CharT, Traits, std::pmr::polymorphic_allocator<CharT>>;
}

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

Die Elemente eines basic_string werden zusammenhängend gespeichert, das heißt, für ein basic_string s, &*(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, ein Zeiger auf s[0] kann an Funktionen übergeben werden, die einen Zeiger auf das erste Element von einem Array(bis C++11)einem nullterminierten Array(seit C++11) von CharT erwarten.

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

Wenn einer von Traits::char_type und Allocator::char_type sich von CharT unterscheidet, ist das Programm fehlerhaft (ill-formed).

Mehrere Typedefs für gebräuchliche Zeichentypen werden 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