WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::u8string — eine Zeichenkette aus UTF-8-Codeeinheiten

std::u8string ist ein Alias für std::basic_string<char8_t> aus <string>. Der Typ speichert UTF-8-Codeeinheiten, überprüft aber nicht die Gültigkeit der Kodierung; size() zählt keine Zeichen, wie sie Nutzer wahrnehmen.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <string>
std::u8string text = u8"...";
// Alias: std::basic_string<char8_t>

std::u8string aus <string> ist ein Alias für std::basic_string<char8_t>. Der Typ verwaltet zusammenhängenden Speicher und unterstützt das Ändern der Länge der Zeichenkette. Initialisiere ihn mit einem UTF-8-Literal, zum Beispiel std::u8string text = u8"A\u00E9";. Das Präfix u8 erzeugt ein Literal mit Elementen vom Typ char8_t.

size() und der Indexzugriff beziehen sich auf Codeeinheiten, nicht auf Unicode-Codepoints oder vom Nutzer wahrgenommene Zeichen. Im Beispiel belegen A, é und ! zusammen vier UTF-8-Codeeinheiten. Ein Zugriff an einem einzelnen Index kann die mehrteilige Kodierung eines Zeichens auftrennen. Der Container überprüft weder UTF-8 noch führt er eine Unicode-Normalisierung durch.

c_str() stellt einen const char8_t* bereit; das abschließende Nullzeichen ist nicht in size() enthalten. Es handelt sich nicht um const char*: std::u8string wird nicht implizit zu std::string konvertiert und kann nicht direkt mit std::cout << text ausgegeben werden. Für die Einbindung in eine char-basierte Schnittstelle müssen die Repräsentation und der Kodierungsvertrag ausdrücklich behandelt werden.

Dieser Eintrag bezieht sich auf C++23. Der im Repository angegebene Kompilierungsstandard belegt keine Laufzeitkompatibilität in der Produktionsumgebung. Die Quelle eel.is ist ein fortlaufend weiterentwickelter Entwurf und keine unveränderliche C++23-Veröffentlichung.

Beispiele

#include <iostream>
#include <string>

int main() {
    std::u8string text = u8"A\u00E9";
    text += u8"!";
    std::cout << "code units: " << text.size() << '\n';
    std::cout << "terminator: "
              << static_cast<unsigned int>(text.c_str()[text.size()])
              << '\n';
}

Ergebnis

code units: 4
terminator: 0

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