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.