KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

c8rtomb — C23-bibliotheekfunctie

`c8rtomb(s, c8, ps)` zet een als UTF-8 gecodeerde `char8_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 c8rtomb(char * restrict s, char8_t c8, mbstate_t * restrict ps);

c8rtomb(s, c8, ps) zet een als UTF-8 gecodeerde char8_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 u8'A' door, ontvangt het één-byte-teken A en bevestigt met mbsinit dat de toestand initieel blijft.

Omdat de invoer UTF-8 is, kan een teken meerdere char8_t-eenheden vereisen; eerdere aanroepen schrijven dan niets en retourneren 0. 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 = c8rtomb(output, u8'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 `u8'A'` door, ontvangt het één-byte-teken `A` en bevestigt met `mbsinit` dat de toestand initieel blijft.

Bronnen