CKTIS / C
mbrtoc8 — C23-functie voor Unicodeconversie
`mbrtoc8(pc8, s, n, ps)` uit C23-`<uchar.h>` zet het volgende multibyte-teken van de uitvoeringscodering om in opeenvolgende UTF-8-`char8_t`-eenheden; in C23 is `char8_t` hetzelfde type als `unsigned char`. Het onderzoekt hoogstens `n` bytes en `mbstate_t` bewaart een deelteken en wachtende eenheden.
Versie: 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) uit C23-<uchar.h> zet het volgende multibyte-teken van de uitvoeringscodering om in opeenvolgende UTF-8-char8_t-eenheden; in C23 is char8_t hetzelfde type als unsigned char. Het onderzoekt hoogstens n bytes en mbstate_t bewaart een deelteken en wachtende eenheden.
Het voorbeeld gebruikt expliciete toestand en roept mbrtoc8 werkelijk aan voor het één byte lange "!". De functie retourneert 1, bewaart UTF-8-eenheid 0x21 en uitvoer 1 21 controleert beide effecten. De code vereist een C23-bibliotheek die deze nieuw gestandaardiseerde functie levert.
0 betekent het nul-teken en de begintoestand, -2 onvolledige invoer, -1 een EILSEQ-fout met ongespecificeerde toestand en -3 een volgende UTF-8-eenheid van het vorige teken zonder nieuwe bytes. Schuif s na -3 niet op; geef na -2 restbytes met hetzelfde ps. Bij s == NULL is de aanroep exact gelijk aan mbrtoc8(NULL, "", 1, ps); pc8 en n worden genegeerd. Dit is de voorgeschreven aanroep met lege tekenreeks in de huidige conversietoestand, geen belofte van een onvoorwaardelijke reset. Bij niet-null s slaat pc8 == NULL alleen opslag over; expliciete ps vermijdt interne toestand zonder race-vrijgarantie.
Voorbeelden
#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;}
Resultaat
1 21
Het voorbeeld gebruikt expliciete toestand en roept `mbrtoc8` werkelijk aan voor het één byte lange `"!"`. De functie retourneert `1`, bewaart UTF-8-eenheid `0x21` en uitvoer `1 21` controleert beide effecten. De code vereist een C23-bibliotheek die deze nieuw gestandaardiseerde functie levert.