WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen