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