CKTIS / C
<uchar.h> — Unicode-Hilfsmittel
Der Header <uchar.h> stellt Typen für Unicode-Codeeinheiten sowie Funktionen zur Konvertierung zwischen den jeweiligen UTF-Formaten und der Mehrbyte-Codierung der aktuellen LC_CTYPE-Einstellung bereit.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <uchar.h><uchar.h> deklariert char8_t, char16_t, char32_t, size_t und mbstate_t. Bei Konvertierungen stehen die ersten drei Typen für Codeeinheiten von UTF-8, UTF-16 bzw. UTF-32. Eine Codeeinheit entspricht nicht immer einem vollständigen Zeichen.
Die Paare mbrtoc8/c8rtomb, mbrtoc16/c16rtomb und mbrtoc32/c32rtomb konvertieren zwischen der Mehrbyte-Codierung der aktuellen LC_CTYPE-Einstellung und dem jeweiligen UTF-Format. Die beim Kompilieren für gewöhnliche Literale gewählte Codierung bestimmt nicht, welche Mehrbyte-Codierung diese Funktionen verwenden. Gehe nicht davon aus, dass die aktuelle Mehrbyte-Codierung UTF-8 ist; bewahre den Zustand von mbstate_t zwischen zusammengehörigen Aufrufen.
Das Beispiel zählt unabhängig von der Locale die Codeeinheiten in einem UTF-8-Literal ohne die abschließende Null. Es ruft keine dieser Konvertierungsfunktionen auf. Das Compiler-Flag im Repository belegt nicht, dass die Produktionslaufzeitumgebung diese Funktionen unterstützt.
Beispiele
#include <stdio.h>
#include <uchar.h>
#if !defined(__STDC_VERSION_UCHAR_H__)
typedef unsigned char char8_t;
#endif
int main(void)
{
const char8_t text[] = u8"é";
const size_t units = sizeof text / sizeof text[0] - 1;
printf("%zu\n", units);
return 0;
}
Ergebnis
2
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.