CKTIS / C
mbrtoc32 — funkcija pretvorbe Unicode C23
`mbrtoc32(pc32, s, n, ps)` iz `<uchar.h>` pretvori največ `n` bajtov naslednjega večbajtnega znaka izvedbenega kodiranja v enoto UTF-32 tipa `char32_t`. Stanje `mbstate_t` omogoči nadaljevanje znaka čez meje medpomnilnikov; ničelni `pc32` še vedno pretvarja, le ne shrani.
Različica: 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> pretvori največ n bajtov naslednjega večbajtnega znaka izvedbenega kodiranja v enoto UTF-32 tipa char32_t. Stanje mbstate_t omogoči nadaljevanje znaka čez meje medpomnilnikov; ničelni pc32 še vedno pretvarja, le ne shrani.
Primer poda ničelno inicializirano stanje in enobajtni niz "Z". mbrtoc32 vrne število porabljenih bajtov 1, shrani U+0000005A, celoten izhod pa je 1 U+0000005A.
Vrnjena 0 pomeni ničelni znak in obnovitev začetnega stanja; -2 zahteva več bajtov, -1 pomeni EILSEQ in pusti stanje nedoločeno, -3 pa lahko dostavi naslednji rezultat prejšnjega znaka brez porabe vhoda. Po -2 nadaljujte s preostalimi bajti in istim ps; po -3 vhoda ne premaknite. Pri s == NULL je klic natančno enakovreden mbrtoc32(NULL, "", 1, ps); pc32 in n se prezreta. To je predpisani klic s praznim nizom v trenutnem stanju pretvorbe, ne obljuba brezpogojne ponastavitve. Pri neničelnem s vrednost pc32 == 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};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
Primer poda ničelno inicializirano stanje in enobajtni niz `"Z"`. `mbrtoc32` vrne število porabljenih bajtov `1`, shrani `U+0000005A`, celoten izhod pa je `1 U+0000005A`.