Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

c32rtomb — fonction de bibliothèque C23

`c32rtomb(s, c32, ps)` convertit une unité `char32_t` codée en UTF-32 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 c32rtomb(char * restrict s, char32_t c32, mbstate_t * restrict ps);

c32rtomb(s, c32, ps) convertit une unité char32_t codée en UTF-32 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.

Une unité char32_t fournit un caractère UTF-32 complet ; contrairement aux formes c8/c16, cette fonction n’assemble pas plusieurs unités d’entrée. 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 = c32rtomb(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.

Sources