WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen