CKTIS / C
mbrtoc8 — funkce převodu Unicode C23
`mbrtoc8(pc8, s, n, ps)` z C23 `<uchar.h>` převádí další vícebajtový znak prováděcího kódování na postupné jednotky UTF-8 typu `char8_t`; v C23 je `char8_t` stejný typ jako `unsigned char`. Prozkoumá nejvýše `n` bajtů a `mbstate_t` zachová částečný znak i čekající jednotky.
Verze: C23
Syntaxe
size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc8(pc8, s, n, ps) z C23 <uchar.h> převádí další vícebajtový znak prováděcího kódování na postupné jednotky UTF-8 typu char8_t; v C23 je char8_t stejný typ jako unsigned char. Prozkoumá nejvýše n bajtů a mbstate_t zachová částečný znak i čekající jednotky.
Příklad používá vlastní stav a skutečně volá mbrtoc8 pro jednobajtové "!". Funkce vrátí 1, uloží jednotku UTF-8 0x21 a výstup 1 21 ověřuje oba účinky. Kód vyžaduje knihovnu C23, která tuto nově standardizovanou funkci poskytuje.
0 značí nulový znak a počáteční stav, -2 neúplný vstup, -1 chybu EILSEQ s neurčeným stavem a -3 uložení další jednotky UTF-8 předchozího znaku bez nových bajtů. Po -3 neposouvejte s; po -2 dodejte zbývající bajty se stejným ps. Při s == NULL volání přesně odpovídá mbrtoc8(NULL, "", 1, ps); pc8 a n se ignorují. Jde o předepsané volání s prázdným řetězcem v aktuálním stavu převodu, nikoli o slib bezpodmínečného resetu. Při nenulovém s hodnota pc8 == NULL potlačí jen uložení; vlastní ps se vyhne internímu stavu bez záruky proti datovým závodům.
Příklady
#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;}
Výsledek
1 21
Příklad používá vlastní stav a skutečně volá `mbrtoc8` pro jednobajtové `"!"`. Funkce vrátí `1`, uloží jednotku UTF-8 `0x21` a výstup `1 21` ověřuje oba účinky. Kód vyžaduje knihovnu C23, která tuto nově standardizovanou funkci poskytuje.