Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri