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.