Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori