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

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`.

Viri