CKTIS / C
mbrtoc8 — функция за Unicode преобразуване в C23
`mbrtoc8(pc8, s, n, ps)` от C23 `<uchar.h>` преобразува следващия многобайтов знак на изпълнимото кодиране в последователни UTF-8 единици `char8_t`; в C23 `char8_t` е същият тип като `unsigned char`. Функцията преглежда най-много `n` байта, а `mbstate_t` пази частичния знак и чакащи единици.
Версия: C23
Синтаксис
size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc8(pc8, s, n, ps) от C23 <uchar.h> преобразува следващия многобайтов знак на изпълнимото кодиране в последователни UTF-8 единици char8_t; в C23 char8_t е същият тип като unsigned char. Функцията преглежда най-много n байта, а mbstate_t пази частичния знак и чакащи единици.
Примерът използва изрично състояние и действително извиква mbrtoc8 за еднобайтовото "!". Функцията връща 1, записва UTF-8 единица 0x21, а изходът 1 21 проверява двата ефекта. Кодът изисква C23 библиотека, която предоставя тази новостандартизирана функция.
0 означава нулев знак и начално състояние, -2 — непълен вход, -1 — грешка EILSEQ с неуточнено състояние, а -3 — запис на следваща UTF-8 единица от предишния знак без нови байтове. След -3 не местете s; след -2 подайте оставащите байтове със същия ps. Когато s == NULL, извикването е точно еквивалентно на mbrtoc8(NULL, "", 1, ps); pc8 и n се игнорират. Това е зададеното извикване с празен низ в текущото състояние на преобразуване, не обещание за безусловен reset. При ненулево s, pc8 == NULL пропуска само записа; собствен ps избягва вътрешно състояние без гаранция срещу data race.
Примери
#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;}
Резултат
1 21
Примерът използва изрично състояние и действително извиква `mbrtoc8` за еднобайтовото `"!"`. Функцията връща `1`, записва UTF-8 единица `0x21`, а изходът `1 21` проверява двата ефекта. Кодът изисква C23 библиотека, която предоставя тази новостандартизирана функция.