CKTIS / C
c16rtomb — C23-bibliotheekfunctie
`c16rtomb(s, c16, ps)` zet een als UTF-16 gecodeerde `char16_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 c16rtomb(char * restrict s, char16_t c16, mbstate_t * restrict ps);c16rtomb(s, c16, ps) zet een als UTF-16 gecodeerde char16_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.
In UTF-16 kan een teken buiten het BMP een surrogaatpaar zijn: de eerste aanroep kan 0 retourneren en pas de tweede eenheid voltooit het teken en produceert bytes. 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 = c16rtomb(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.