CKTIS / C++
std::wstring — eine Zeichenkette aus wchar_t-Elementen
std::wstring ist ein in <string> definiertes Alias für std::basic_string<wchar_t>. Es verwaltet den Speicher der Zeichenkette und unterstützt Anhängen, Vergleiche und Elementzugriff. Eine portable Unicode-Kodierung wird nicht garantiert.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <string>
std::wstring text = L"Hello";std::wstring ist ein Alias für std::basic_string<wchar_t> aus <string>. Es speichert eine Folge von wchar_t-Elementen zusammenhängend im Speicher, verwaltet deren Lebensdauer und erlaubt, die Länge der Zeichenkette zu ändern. Das Präfix L erzeugt Wide-Literale: L"cat" ist ein Stringliteral und L'C' ein Zeichenliteral.
size() gibt die Anzahl der gespeicherten wchar_t-Elemente ohne das abschließende Nullelement zurück. Dies ist im Allgemeinen weder die Anzahl der Unicode-Codepoints noch die der vom Benutzer wahrgenommenen Zeichen. Die Breite von wchar_t und die Kodierung von Wide-Literalen hängen von der Implementierung ab; std::wstring garantiert weder UTF-16 noch UTF-32. Text aus std::string wird ebenfalls nicht automatisch konvertiert.
Der Operator += hängt Text an. at(i) ermöglicht einen zugriffsgeprüften Elementzugriff und löst std::out_of_range aus, wenn i >= size() gilt. Die Methode c_str() stellt einen Zeiger auf nullterminierte Daten bereit, der für Schnittstellen nützlich ist, die const wchar_t* akzeptieren. Eine Zeichenkette kann auch eingebettete Nullen enthalten; eine Schnittstelle, die sich ausschließlich auf einen Terminator stützt, behandelt jedoch die erste davon als Textende.
Das Beispiel erstellt L"cat", hängt L"s" an und ändert das erste Element. Mit std::cout gibt es nur die Länge und das Vergleichsergebnis aus, sodass keine Wide-Zeichen im Terminal dargestellt werden müssen. Die erwarteten Zeilen sind 4 und 1. Diese Beschreibung behandelt in C++23 verfügbare Operationen; die angegebene Quelle ist ein fortlaufend weiterentwickelter Standardentwurf und keine unveränderliche C++23-Veröffentlichung.
Beispiele
#include <iostream>
#include <string>
int main() {
std::wstring text = L"cat";
text += L"s";
text.at(0) = L'C';
std::cout << text.size() << '\n';
std::cout << (text == L"Cats") << '\n';
}
Ergebnis
4 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.