База знанияИзпитен център
BGБългарски
Избери език13

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 единицата.

Източници