CKTIS / C
mbrtoc16 — funkcija pretvorbe Unicode C23
`mbrtoc16(pc16, s, n, ps)` iz `<uchar.h>` pregleda največ `n` bajtov naslednjega večbajtnega znaka izvedbenega kodiranja in shrani ustrezno enoto UTF-16 tipa `char16_t`. Objekt `mbstate_t`, na katerega kaže `ps`, ohrani stanje med klici; `pc16 == NULL` izpusti samo shranjevanje.
Različica: C23
Sintaksa
size_t mbrtoc16(char16_t * restrict pc16, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc16(pc16, s, n, ps) iz <uchar.h> pregleda največ n bajtov naslednjega večbajtnega znaka izvedbenega kodiranja in shrani ustrezno enoto UTF-16 tipa char16_t. Objekt mbstate_t, na katerega kaže ps, ohrani stanje med klici; pc16 == NULL izpusti samo shranjevanje.
Primer uporabi izrecno ničelno inicializirano stanje in pretvori enobajtni "A". Funkcija porabi en bajt, shrani U+0041 in program izpiše 1 U+0041; zato preveri pravi vrnjeni rezultat in enoto UTF-16.
Rezultat 0 pomeni ničelni znak in začetno stanje, -2 nepopoln, a morda veljaven znak in -1 napako kodiranja z errno == EILSEQ ter nedoločenim stanjem. Zunaj BMP nastane nadomestni par: prvi klic porabi bajte, poznejši lahko vrne -3 in shrani naslednjo enoto brez porabe vhoda; takrat s ne premaknite. Pri s == NULL je klic natančno enakovreden mbrtoc16(NULL, "", 1, ps); pc16 in n se prezreta. To je predpisani klic s praznim nizom v trenutnem stanju pretvorbe, ne obljuba brezpogojne ponastavitve. Pri neničelnem s vrednost pc16 == NULL izpusti le shranjevanje; lasten ps se izogne notranjemu stanju brez jamstva pred podatkovnimi tekmami.
Primeri
#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;}
Rezultat
1 U+0041
Primer uporabi izrecno ničelno inicializirano stanje in pretvori enobajtni `"A"`. Funkcija porabi en bajt, shrani `U+0041` in program izpiše `1 U+0041`; zato preveri pravi vrnjeni rezultat in enoto UTF-16.