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

CKTIS / C

mbrtoc32 — fonction de conversion Unicode C23

`mbrtoc32(pc32, s, n, ps)` de `<uchar.h>` convertit au plus `n` octets du prochain caractère multioctet d’exécution en une unité UTF-32 `char32_t`. Son état `mbstate_t` permet de poursuivre un caractère coupé entre tampons ; un `pc32` nul effectue encore la conversion mais ne stocke rien.

Version : C23

Syntaxe

size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc32(pc32, s, n, ps) de <uchar.h> convertit au plus n octets du prochain caractère multioctet d’exécution en une unité UTF-32 char32_t. Son état mbstate_t permet de poursuivre un caractère coupé entre tampons ; un pc32 nul effectue encore la conversion mais ne stocke rien.

L’exemple transmet un état initialisé à zéro et la chaîne "Z" d’un octet. mbrtoc32 renvoie le nombre d’octets consommés 1, stocke U+0000005A, et la sortie complète vaut 1 U+0000005A.

Le retour 0 désigne le caractère nul et le retour à l’état initial ; -2 demande plus d’octets, -1 signifie EILSEQ et laisse l’état non spécifié, tandis que -3 peut livrer un autre résultat du caractère précédent sans consommer l’entrée. Après -2, poursuis avec les octets restants et le même ps ; après -3, n’avance pas l’entrée. Quand s == NULL, l’appel équivaut exactement à mbrtoc32(NULL, "", 1, ps) ; pc32 et n sont ignorés. Il s’agit de l’appel spécifié avec chaîne vide dans l’état courant, non d’une promesse de réinitialisation inconditionnelle. Avec s non nul, pc32 == NULL supprime seulement le stockage ; un ps explicite évite l’état interne non garanti sans data race.

Exemples

#include <stdio.h>
#include <uchar.h>
int main(void){mbstate_t state={0};char32_t unit=0;size_t count=mbrtoc32(&unit,"Z",1,&state);printf("%zu U+%08X\n",count,(unsigned)unit);return 0;}

Résultat

1 U+0000005A

L’exemple transmet un état initialisé à zéro et la chaîne `"Z"` d’un octet. `mbrtoc32` renvoie le nombre d’octets consommés `1`, stocke `U+0000005A`, et la sortie complète vaut `1 U+0000005A`.

Sources