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

CKTIS / C

mbrtoc16 — fonction de conversion Unicode C23

`mbrtoc16(pc16, s, n, ps)` de `<uchar.h>` examine au plus `n` octets du prochain caractère multioctet d’exécution et stocke l’unité `char16_t` UTF-16 correspondante. L’objet `mbstate_t` désigné par `ps` conserve l’état entre appels ; `pc16 == NULL` supprime seulement le stockage du résultat.

Version : C23

Syntaxe

size_t mbrtoc16(char16_t * restrict pc16, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc16(pc16, s, n, ps) de <uchar.h> examine au plus n octets du prochain caractère multioctet d’exécution et stocke l’unité char16_t UTF-16 correspondante. L’objet mbstate_t désigné par ps conserve l’état entre appels ; pc16 == NULL supprime seulement le stockage du résultat.

L’exemple utilise un état explicitement initialisé à zéro et convertit "A", long d’un octet. La fonction consomme un octet, stocke U+0041 et le programme affiche 1 U+0041 ; il contrôle donc le vrai retour et l’unité UTF-16.

Le retour 0 désigne le caractère nul et l’état initial, -2 un caractère incomplet mais potentiellement valide, et -1 une erreur de codage avec errno == EILSEQ et état non spécifié. Hors du BMP, une paire de substituts est produite : le premier appel consomme les octets, un appel ultérieur peut renvoyer -3 et stocker l’unité suivante sans consommer d’entrée ; n’avance donc pas s. Quand s == NULL, l’appel équivaut exactement à mbrtoc16(NULL, "", 1, ps) ; pc16 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, pc16 == 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};char16_t unit=0;size_t count=mbrtoc16(&unit,"A",1,&state);printf("%zu U+%04X\n",count,(unsigned)unit);return 0;}

Résultat

1 U+0041

L’exemple utilise un état explicitement initialisé à zéro et convertit `"A"`, long d’un octet. La fonction consomme un octet, stocke `U+0041` et le programme affiche `1 U+0041` ; il contrôle donc le vrai retour et l’unité UTF-16.

Sources