CKTIS / C
mbrtowc — conversion multioctet redémarrable C23
`mbrtowc(pwc, s, n, ps)` de `<wchar.h>` examine au plus `n` octets du prochain caractère multioctet dans l’encodage d’exécution courant. Quand un caractère valide est achevé, elle renvoie le nombre d’octets qui l’ont complété et stocke le `wchar_t` correspondant si `pwc != NULL` ; le `mbstate_t` désigné par `ps` poursuit un caractère coupé entre tampons.
Version : C23
Syntaxe
size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtowc(pwc, s, n, ps) de <wchar.h> examine au plus n octets du prochain caractère multioctet dans l’encodage d’exécution courant. Quand un caractère valide est achevé, elle renvoie le nombre d’octets qui l’ont complété et stocke le wchar_t correspondant si pwc != NULL ; le mbstate_t désigné par ps poursuit un caractère coupé entre tampons.
L’exemple sélectionne la locale garantie "C", initialise explicitement l’état à zéro et convertit réellement le "A" d’un octet. La sortie 1 0041 1 confirme un octet consommé, la valeur du caractère large et le retour à l’état initial selon mbsinit.
Le retour 0 désigne le caractère large nul et l’état initial, (size_t)-2 un caractère incomplet mais potentiellement valide sans stockage, et (size_t)-1 une erreur avec errno == EILSEQ, sans stockage et avec état non spécifié. Après -2, fournis les octets suivants avec le même ps ; après -1, réinitialise avant de poursuivre. s == NULL équivaut exactement à mbrtowc(NULL, "", 1, ps), ps == NULL choisit un état interne non garanti sans data race, et wchar_t n’est pas nécessairement un point de code Unicode. Quand s == NULL, les valeurs pwc et n fournies par l’appelant sont ignorées.
Exemples
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void){setlocale(LC_CTYPE,"C");mbstate_t state={0};wchar_t wc=0;size_t n=mbrtowc(&wc,"A",1,&state);printf("%zu %04lX %d\n",n,(unsigned long)wc,mbsinit(&state)!=0);return 0;}
Résultat
1 0041 1
L’exemple sélectionne la locale garantie `"C"`, initialise explicitement l’état à zéro et convertit réellement le `"A"` d’un octet. La sortie `1 0041 1` confirme un octet consommé, la valeur du caractère large et le retour à l’état initial selon `mbsinit`.