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

CKTIS / C

mbrtoc8 — fonction de conversion Unicode C23

`mbrtoc8(pc8, s, n, ps)` de `<uchar.h>` C23 convertit le prochain caractère multioctet d’exécution en unités UTF-8 `char8_t` successives ; en C23, `char8_t` est le même type que `unsigned char`. La fonction examine au plus `n` octets, tandis que `mbstate_t` retient caractère partiel et unités en attente.

Version : C23

Syntaxe

size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc8(pc8, s, n, ps) de <uchar.h> C23 convertit le prochain caractère multioctet d’exécution en unités UTF-8 char8_t successives ; en C23, char8_t est le même type que unsigned char. La fonction examine au plus n octets, tandis que mbstate_t retient caractère partiel et unités en attente.

L’exemple emploie un état explicite et appelle réellement mbrtoc8 pour "!", long d’un octet. La fonction renvoie 1, stocke l’unité UTF-8 0x21, et la sortie 1 21 vérifie les deux effets. Le code exige une bibliothèque C23 fournissant cette nouvelle fonction normalisée.

0 désigne le caractère nul et l’état initial, -2 une entrée incomplète, -1 une erreur EILSEQ avec état non spécifié, et -3 le stockage d’une unité UTF-8 suivante du caractère précédent sans nouvel octet. N’avance pas s après -3 ; après -2, fournis les octets restants avec le même ps. Quand s == NULL, l’appel équivaut exactement à mbrtoc8(NULL, "", 1, ps) ; pc8 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, pc8 == 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};char8_t unit=0;size_t count=mbrtoc8(&unit,"!",1,&state);printf("%zu %02X\n",count,(unsigned)unit);return 0;}

Résultat

1 21

L’exemple emploie un état explicite et appelle réellement `mbrtoc8` pour `"!"`, long d’un octet. La fonction renvoie `1`, stocke l’unité UTF-8 `0x21`, et la sortie `1 21` vérifie les deux effets. Le code exige une bibliothèque C23 fournissant cette nouvelle fonction normalisée.

Sources