Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

mbrtoc16 — funkce převodu Unicode C23

`mbrtoc16(pc16, s, n, ps)` z `<uchar.h>` prozkoumá nejvýše `n` bajtů dalšího vícebajtového znaku prováděcího kódování a uloží odpovídající jednotku UTF-16 typu `char16_t`. Objekt `mbstate_t` určený `ps` zachovává stav mezi voláními; `pc16 == NULL` potlačí jen uložení výsledku.

Verze: C23

Syntaxe

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> prozkoumá nejvýše n bajtů dalšího vícebajtového znaku prováděcího kódování a uloží odpovídající jednotku UTF-16 typu char16_t. Objekt mbstate_t určený ps zachovává stav mezi voláními; pc16 == NULL potlačí jen uložení výsledku.

Příklad používá výslovně nulově inicializovaný stav a převádí jednobajtové "A". Funkce spotřebuje jeden bajt, uloží U+0041 a program vypíše 1 U+0041; ověřuje tedy skutečný návrat i jednotku UTF-16.

Výsledek 0 značí nulový znak a počáteční stav, -2 neúplný, ale potenciálně platný znak a -1 chybu kódování s errno == EILSEQ a neurčeným stavem. Mimo BMP vznikne pár surogátů: první volání spotřebuje bajty, pozdější může vrátit -3 a uložit další jednotku bez spotřeby vstupu; tehdy s neposouvejte. Při s == NULL volání přesně odpovídá mbrtoc16(NULL, "", 1, ps); pc16 a n se ignorují. Jde o předepsané volání s prázdným řetězcem v aktuálním stavu převodu, nikoli o slib bezpodmínečného resetu. Při nenulovém s hodnota pc16 == NULL potlačí jen uložení; vlastní ps se vyhne internímu stavu bez záruky proti datovým závodům.

Příklady

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

Výsledek

1 U+0041

Příklad používá výslovně nulově inicializovaný stav a převádí jednobajtové `"A"`. Funkce spotřebuje jeden bajt, uloží `U+0041` a program vypíše `1 U+0041`; ověřuje tedy skutečný návrat i jednotku UTF-16.

Zdroje