KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

mbrtoc32 — C23-functie voor Unicodeconversie

`mbrtoc32(pc32, s, n, ps)` uit `<uchar.h>` zet hoogstens `n` bytes van het volgende multibyte-teken van de uitvoeringscodering om in een UTF-32-`char32_t`-eenheid. De `mbstate_t`-toestand laat een teken over buffergrenzen doorgaan; een null-`pc32` converteert wel maar slaat niets op.

Versie: C23

Syntax

size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc32(pc32, s, n, ps) uit <uchar.h> zet hoogstens n bytes van het volgende multibyte-teken van de uitvoeringscodering om in een UTF-32-char32_t-eenheid. De mbstate_t-toestand laat een teken over buffergrenzen doorgaan; een null-pc32 converteert wel maar slaat niets op.

Het voorbeeld geeft een nulgeïnitialiseerde toestand en het één byte lange "Z" door. mbrtoc32 retourneert het aantal verbruikte bytes 1, bewaart U+0000005A en de volledige uitvoer is 1 U+0000005A.

Retour 0 betekent het nul-teken en herstel van de begintoestand; -2 vraagt meer bytes, -1 betekent EILSEQ en laat de toestand ongespecificeerd, terwijl -3 een volgend resultaat van het vorige teken zonder invoerverbruik kan leveren. Ga na -2 verder met restbytes en hetzelfde ps; schuif na -3 niet op. Bij s == NULL is de aanroep exact gelijk aan mbrtoc32(NULL, "", 1, ps); pc32 en n worden genegeerd. Dit is de voorgeschreven aanroep met lege tekenreeks in de huidige conversietoestand, geen belofte van een onvoorwaardelijke reset. Bij niet-null s slaat pc32 == NULL alleen opslag over; expliciete ps vermijdt interne toestand zonder race-vrijgarantie.

Voorbeelden

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

Resultaat

1 U+0000005A

Het voorbeeld geeft een nulgeïnitialiseerde toestand en het één byte lange `"Z"` door. `mbrtoc32` retourneert het aantal verbruikte bytes `1`, bewaart `U+0000005A` en de volledige uitvoer is `1 U+0000005A`.

Bronnen