CKTIS / C
c8rtomb — fonction de bibliothèque C23
`c8rtomb(s, c8, ps)` convertit une unité `char8_t` codée en UTF-8 vers la représentation multioctet du `LC_CTYPE` courant, stocke au plus `MB_CUR_MAX` octets et renvoie leur nombre, séquences de décalage comprises.
Version : C23
Syntaxe
size_t c8rtomb(char * restrict s, char8_t c8, mbstate_t * restrict ps);c8rtomb(s, c8, ps) convertit une unité char8_t codée en UTF-8 vers la représentation multioctet du LC_CTYPE courant, stocke au plus MB_CUR_MAX octets et renvoie leur nombre, séquences de décalage comprises.
Utilisez un mbstate_t explicite pour convertir un flux. L’exemple transmet u8'A', obtient le caractère mono-octet A et confirme avec mbsinit que l’état reste initial.
L’entrée étant en UTF-8, un caractère peut nécessiter plusieurs unités char8_t ; les premiers appels ne stockent alors rien et renvoient 0. Un s nul effectue la conversion équivalente du caractère nul dans un tampon interne et restaure l’état initial. Une erreur renvoie (size_t)-1, fixe errno = EILSEQ et laisse l’état non spécifié ; un ps nul choisit un état interne sans garantie contre les courses.
Exemples
#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;
}
Résultat
1 A 1
Utilisez un `mbstate_t` explicite pour convertir un flux. L’exemple transmet `u8'A'`, obtient le caractère mono-octet `A` et confirme avec `mbsinit` que l’état reste initial.