WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

mbrtoc8 — C23-Unicode-Konvertierungsfunktion

`mbrtoc8(pc8, s, n, ps)` aus C23-`<uchar.h>` wandelt das nächste Multibytezeichen der Ausführungsumgebung in aufeinanderfolgende UTF-8-Einheiten vom Typ `char8_t` um; in C23 ist `char8_t` derselbe Typ wie `unsigned char`. Es werden höchstens `n` Bytes untersucht, während `mbstate_t` Teilzeichen und ausstehende Einheiten hält.

Version: C23

Syntax

size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc8(pc8, s, n, ps) aus C23-<uchar.h> wandelt das nächste Multibytezeichen der Ausführungsumgebung in aufeinanderfolgende UTF-8-Einheiten vom Typ char8_t um; in C23 ist char8_t derselbe Typ wie unsigned char. Es werden höchstens n Bytes untersucht, während mbstate_t Teilzeichen und ausstehende Einheiten hält.

Das Beispiel verwendet eigenen Zustand und ruft mbrtoc8 wirklich für das einbyteige "!" auf. Die Funktion liefert 1, speichert die UTF-8-Einheit 0x21, und 1 21 prüft beide Wirkungen. Der Code verlangt eine C23-Bibliothek, die diese neu standardisierte Funktion bereitstellt.

0 bezeichnet Nullzeichen und Anfangszustand, -2 unvollständige Eingabe, -1 einen EILSEQ-Fehler mit unbestimmtem Zustand und -3 eine weitere UTF-8-Einheit des vorherigen Zeichens ohne neue Bytes. Nach -3 s nicht vorrücken; nach -2 Restbytes mit demselben ps liefern. Bei s == NULL entspricht der Aufruf exakt mbrtoc8(NULL, "", 1, ps); pc8 und n werden ignoriert. Dies ist der festgelegte Aufruf mit leerer Zeichenfolge im aktuellen Konvertierungszustand, keine Zusage eines bedingungslosen Resets. Bei nicht-null s unterdrückt pc8 == NULL nur das Speichern; eigener ps vermeidet den internen Zustand ohne Race-Freiheitsgarantie.

Beispiele

#include <stdio.h>
#include <uchar.h>
int main(void){mbstate_t state={0};char8_t unit=0;size_t count=mbrtoc8(&unit,"!",1,&state);printf("%zu %02X\n",count,(unsigned)unit);return 0;}

Ergebnis

1 21

Das Beispiel verwendet eigenen Zustand und ruft `mbrtoc8` wirklich für das einbyteige `"!"` auf. Die Funktion liefert `1`, speichert die UTF-8-Einheit `0x21`, und `1 21` prüft beide Wirkungen. Der Code verlangt eine C23-Bibliothek, die diese neu standardisierte Funktion bereitstellt.

Quellen