CKTIS / C
c16rtomb — fonction de bibliothèque C23
`c16rtomb(s, c16, ps)` convertit une unité `char16_t` codée en UTF-16 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 c16rtomb(char * restrict s, char16_t c16, mbstate_t * restrict ps);c16rtomb(s, c16, ps) convertit une unité char16_t codée en UTF-16 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 u'A', obtient le caractère mono-octet A et confirme avec mbsinit que l’état reste initial.
En UTF-16, un caractère hors BMP peut être une paire de substituts : le premier appel peut renvoyer 0, et seule la seconde unité termine le caractère et produit des octets. 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 = c16rtomb(output, u'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 `u'A'`, obtient le caractère mono-octet `A` et confirme avec `mbsinit` que l’état reste initial.