CKTIS / C
mbrtoc32 — funkcija pretvorbe Unicodea C23
`mbrtoc32(pc32, s, n, ps)` iz `<uchar.h>` pretvara najviše `n` bajtova sljedećeg višebajtnog znaka izvršnog kodiranja u UTF-32 jedinicu tipa `char32_t`. Stanje `mbstate_t` omogućuje nastavak znaka preko granice spremnika; nul-`pc32` i dalje pretvara, samo ne sprema.
Verzija: C23
Sintaksa
size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc32(pc32, s, n, ps) iz <uchar.h> pretvara najviše n bajtova sljedećeg višebajtnog znaka izvršnog kodiranja u UTF-32 jedinicu tipa char32_t. Stanje mbstate_t omogućuje nastavak znaka preko granice spremnika; nul-pc32 i dalje pretvara, samo ne sprema.
Primjer predaje nulom inicijalizirano stanje i jednobajtni niz "Z". mbrtoc32 vraća broj potrošenih bajtova 1, sprema U+0000005A, a cijeli izlaz je 1 U+0000005A.
Povrat 0 znači nul-znak i obnovu početnog stanja; -2 traži još bajtova, -1 znači EILSEQ i ostavlja stanje neodređenim, dok -3 može dati sljedeći rezultat prethodnog znaka bez trošenja ulaza. Nakon -2 nastavi s preostalim bajtovima i istim ps; nakon -3 ne pomiči ulaz. Kada je s == NULL, poziv točno odgovara mbrtoc32(NULL, "", 1, ps); pc32 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, pc32 == 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};char32_t unit=0;size_t count=mbrtoc32(&unit,"Z",1,&state);printf("%zu U+%08X\n",count,(unsigned)unit);return 0;}
Rezultat
1 U+0000005A
Primjer predaje nulom inicijalizirano stanje i jednobajtni niz `"Z"`. `mbrtoc32` vraća broj potrošenih bajtova `1`, sprema `U+0000005A`, a cijeli izlaz je `1 U+0000005A`.