Méthode et exemple d'utilisation de la fonction mbstowcs() de la bibliothèque C

Bibliothèque standard C - <stdlib.h>

Fonction de bibliothèque C size_t mbstowcs(schar_t *pwcs, const char *str, size_t n) Convertir en str La chaîne de caractères multi-octet pointée par les paramètres pwcs Le tableau pointé par.

Déclaration

Voici la déclaration de la fonction mbstowcs().

size_t mbstowcs(schar_t *pwcs, const char *str, size_t n)

Paramètre

• pwcs -- Un tableau de wchar_t pointant à un élément, dont la longueur est suffisante pour stocker une chaîne de caractères large de longueur maximale.
• str -- La chaîne de caractères multi-octet à convertir.
• n -- Nombre maximum de caractères à convertir.

Valeur de retour

Cette fonction retourne le nombre de caractères convertis, sans inclure le caractère de fin de chaîne nul. Si elle rencontre un caractère multi-octet invalide, elle retourne -1 Valeur.

Exemple en ligne

L'exemple suivant démontre l'utilisation de la fonction mbstowcs().

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
int main()
{
   int len;
   char *pmbnull  = NULL;
   char *pmb = (char *)malloc( MB_CUR_MAX );
   wchar_t *pwc = L"Hi";
   wchar_t *pwcs = (wchar_t *)malloc( sizeof( wchar_t ));
   printf("Conversion en chaîne de caractères multi-octet\n");
   len = wcstombs( pmb, pwc, MB_CUR_MAX);
   printf("Caractère multi-octet converti %d\n", len);
   printf("La valeur hexadécimale du premier caractère multi-octet : %%.4x\n", pmb);
   printf("Conversion en chaîne de caractères large\n");
   len = mbstowcs( pwcs, pmb, MB_CUR_MAX);
   printf("Caractère multi-octet converti %d\n", len);
   printf("La valeur hexadécimale du premier caractère large : %%.4x\n\n", pwcs);
   return(0);
}

Lançons la compilation et l'exécution du programme suivant, ce qui produira les résultats suivants :

Conversion en chaîne de caractères multibyte
Caractère converti 1
La valeur hexadécimale du premier caractère multibyte : 0x19a60010
Conversion en chaîne de caractères large
Caractère converti 1
La valeur hexadécimale du premier caractère large : 0x19a60030

Bibliothèque standard C - <stdlib.h>