Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

mbrtoc16 — funkcja konwersji Unicode C23

`mbrtoc16(pc16, s, n, ps)` z `<uchar.h>` czyta najwyżej `n` bajtów następnego znaku w kodowaniu wykonawczym i zapisuje odpowiadającą jednostkę `char16_t` UTF-16. Obiekt `mbstate_t` wskazywany przez `ps` zachowuje stan między wywołaniami; `pc16 == NULL` pomija tylko zapis wyniku.

Wersja: C23

Składnia

size_t mbrtoc16(char16_t * restrict pc16, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc16(pc16, s, n, ps) z <uchar.h> czyta najwyżej n bajtów następnego znaku w kodowaniu wykonawczym i zapisuje odpowiadającą jednostkę char16_t UTF-16. Obiekt mbstate_t wskazywany przez ps zachowuje stan między wywołaniami; pc16 == NULL pomija tylko zapis wyniku.

Przykład używa jawnie wyzerowanego stanu i konwertuje jednobajtowe "A". Funkcja zużywa jeden bajt, zapisuje U+0041, a program wypisuje 1 U+0041; sprawdza zatem rzeczywistą wartość zwrotną i jednostkę UTF-16.

Wynik 0 oznacza znak null i stan początkowy, -2 niepełny lecz potencjalnie poprawny znak, a -1 błąd kodowania z errno == EILSEQ i nieokreślonym stanem. Znak spoza BMP daje parę surogatów: pierwsze wywołanie zużywa bajty, kolejne może zwrócić -3 i zapisać następną jednostkę bez zużycia wejścia, więc nie przesuwaj wtedy s. Gdy s == NULL, wywołanie jest dokładnie równoważne mbrtoc16(NULL, "", 1, ps); parametry pc16 i n są ignorowane. Jest to określone wywołanie z pustym napisem w bieżącym stanie konwersji, a nie obietnica bezwarunkowego resetu. Przy nie-nullowym s wartość pc16 == NULL pomija tylko zapis; jawny ps omija stan wewnętrzny bez gwarancji braku data race.

Przykłady

#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;}

Wynik

1 U+0041

Przykład używa jawnie wyzerowanego stanu i konwertuje jednobajtowe `"A"`. Funkcja zużywa jeden bajt, zapisuje `U+0041`, a program wypisuje `1 U+0041`; sprawdza zatem rzeczywistą wartość zwrotną i jednostkę UTF-16.

Źródła