KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

c32rtomb — C23-bibliotheekfunctie

`c32rtomb(s, c32, ps)` zet een als UTF-32 gecodeerde `char32_t`-eenheid om naar de multibyte-representatie van het huidige `LC_CTYPE`, schrijft maximaal `MB_CUR_MAX` bytes en retourneert het aantal inclusief shiftsequenties.

Versie: C23

Syntax

size_t c32rtomb(char * restrict s, char32_t c32, mbstate_t * restrict ps);

c32rtomb(s, c32, ps) zet een als UTF-32 gecodeerde char32_t-eenheid om naar de multibyte-representatie van het huidige LC_CTYPE, schrijft maximaal MB_CUR_MAX bytes en retourneert het aantal inclusief shiftsequenties.

Gebruik een expliciete mbstate_t bij stroomconversie. Het voorbeeld geeft U'A' door, ontvangt het één-byte-teken A en bevestigt met mbsinit dat de toestand initieel blijft.

Eén char32_t-eenheid levert een volledig UTF-32-teken; anders dan c8/c16 stelt deze functie geen teken uit meerdere invoereenheden samen. Null voor s voert de overeenkomstige nul-tekenconversie naar een interne buffer uit en herstelt de begintoestand. Een fout retourneert (size_t)-1, zet errno = EILSEQ en laat de toestand ongespecificeerd; null ps gebruikt interne toestand zonder verplichte racebescherming.

Voorbeelden

#include <limits.h>
#include <stdio.h>
#include <uchar.h>
#include <wchar.h>

int main(void) {
    mbstate_t state = {0};
    char output[MB_LEN_MAX];
    size_t count = c32rtomb(output, U'A', &state);
    if (count == (size_t)-1) return 1;
    printf("%zu %c %d\n", count, output[0], mbsinit(&state));
    return 0;
}

Resultaat

1 A 1

Gebruik een expliciete `mbstate_t` bij stroomconversie. Het voorbeeld geeft `U'A'` door, ontvangt het één-byte-teken `A` en bevestigt met `mbsinit` dat de toestand initieel blijft.

Bronnen