CKTIS / C
mbrtoc16 — funkcija pretvorbe Unicodea C23
`mbrtoc16(pc16, s, n, ps)` iz `<uchar.h>` pregledava najviše `n` bajtova sljedećeg višebajtnog znaka izvršnog kodiranja i sprema odgovarajuću UTF-16 jedinicu tipa `char16_t`. Objekt `mbstate_t` na koji pokazuje `ps` čuva stanje između poziva; `pc16 == NULL` preskače samo spremanje.
Verzija: 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> pregledava najviše n bajtova sljedećeg višebajtnog znaka izvršnog kodiranja i sprema odgovarajuću UTF-16 jedinicu tipa char16_t. Objekt mbstate_t na koji pokazuje ps čuva stanje između poziva; pc16 == NULL preskače samo spremanje.
Primjer koristi izričito nulom inicijalizirano stanje i pretvara jednobajtni "A". Funkcija troši jedan bajt, sprema U+0041 i program ispisuje 1 U+0041; tako provjerava stvarni povrat i UTF-16 jedinicu.
Rezultat 0 znači nul-znak i početno stanje, -2 nepotpun ali možda valjan znak, a -1 pogrešku kodiranja s errno == EILSEQ i neodređenim stanjem. Izvan BMP-a nastaje surogatni par: prvi poziv troši bajtove, kasniji može vratiti -3 i spremiti sljedeću jedinicu bez trošenja ulaza; tada ne pomiči s. Kada je s == NULL, poziv točno odgovara mbrtoc16(NULL, "", 1, ps); pc16 i n se zanemaruju. To je propisani poziv s praznim nizom u trenutačnom stanju pretvorbe, a ne obećanje bezuvjetnog reseta. Uz nenulti s, pc16 == NULL preskače samo spremanje; vlastiti ps izbjegava unutarnje stanje bez jamstva protiv data racea.
Primjeri
#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
Primjer koristi izričito nulom inicijalizirano stanje i pretvara jednobajtni `"A"`. Funkcija troši jedan bajt, sprema `U+0041` i program ispisuje `1 U+0041`; tako provjerava stvarni povrat i UTF-16 jedinicu.