CKTIS / C
mbrtoc16 — funkcia prevodu Unicode C23
`mbrtoc16(pc16, s, n, ps)` z `<uchar.h>` preskúma najviac `n` bajtov ďalšieho viacbajtového znaku vykonávacieho kódovania a uloží zodpovedajúcu jednotku UTF-16 typu `char16_t`. Objekt `mbstate_t` určený `ps` zachováva stav medzi volaniami; `pc16 == NULL` potlačí iba uloženie výsledku.
Verzia: C23
Syntax
size_t mbrtoc16(char16_t * restrict pc16, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc16(pc16, s, n, ps) z <uchar.h> preskúma najviac n bajtov ďalšieho viacbajtového znaku vykonávacieho kódovania a uloží zodpovedajúcu jednotku UTF-16 typu char16_t. Objekt mbstate_t určený ps zachováva stav medzi volaniami; pc16 == NULL potlačí iba uloženie výsledku.
Príklad používa výslovne nulovo inicializovaný stav a prevádza jednobajtové "A". Funkcia spotrebuje jeden bajt, uloží U+0041 a program vypíše 1 U+0041; overuje teda skutočný návrat aj jednotku UTF-16.
Výsledok 0 označuje nulový znak a počiatočný stav, -2 neúplný, ale potenciálne platný znak a -1 chybu kódovania s errno == EILSEQ a nešpecifikovaným stavom. Mimo BMP vznikne pár surogátov: prvé volanie spotrebuje bajty, neskoršie môže vrátiť -3 a uložiť ďalšiu jednotku bez spotreby vstupu; vtedy s neposúvajte. Pri s == NULL volanie presne zodpovedá mbrtoc16(NULL, "", 1, ps); pc16 a n sa ignorujú. Ide o predpísané volanie s prázdnym reťazcom v aktuálnom stave prevodu, nie o prísľub bezpodmienečného resetu. Pri nenulovom s hodnota pc16 == NULL potlačí iba uloženie; vlastný ps sa vyhne internému stavu bez záruky proti dátovým pretekom.
Príklady
#include <stdio.h>
#include <uchar.h>
int main(void){mbstate_t state={0};char16_t unit=0;size_t count=mbrtoc16(&unit,"A",1,&state);printf("%zu U+%04X\n",count,(unsigned)unit);return 0;}
Výsledok
1 U+0041
Príklad používa výslovne nulovo inicializovaný stav a prevádza jednobajtové `"A"`. Funkcia spotrebuje jeden bajt, uloží `U+0041` a program vypíše `1 U+0041`; overuje teda skutočný návrat aj jednotku UTF-16.