Fonctions de la bibliothèque C -mbstowcs()
Bibliothèque standard C - <stdlib.h>
Description
Fonctions de la bibliothèque CmbstowcsUtilisée pour convertir une chaîne de caractères multioctets en une chaîne de caractères larges.
mbstowcsLa fonction est définie dans le fichier d'en-tête <stdlib.h>.
Déclaration
Voici la déclaration de la fonction mbstowcs().
size_t mbstowcs(wchar_t *pwcs, const char *mbs, size_t n);
Paramètre
pwcs: Pointe vers un tampon utilisé pour stocker la chaîne de caractères larges convertie. Sipwcsest NULL, la fonction renvoie la longueur de tampon requise sans effectuer la conversion réelle.mbs: Pointeur vers une chaîne de caractères multioctets.n: Le nombre maximal de caractères à convertir. Si, avant de rencontrer le caractère de terminaison, la conversion a déjà été effectuéencaractères, la conversion s'arrête prématurément.
Valeur de retour
- En cas de succès, renvoie le nombre de caractères larges convertis, à l'exclusion du caractère nul terminal.
- Si une séquence multioctet non valide est rencontrée, renvoie
(size_t)-1, et définiterrno。
Exemple
L'exemple suivant illustre l'utilisation de la fonction mbstowcs().
Exemple 1
#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("Convertir en une chaîne multioctet\n");
len = wcstombs( pmb, pwc, MB_CUR_MAX);
printf("Caractère converti %d\n", len);
printf("Valeur hexadécimale du premier caractère multioctet : %#.4x\n", pmb);
printf("Reconvertir en chaîne de caractères larges\n");
len = mbstowcs( pwcs, pmb, MB_CUR_MAX);
printf("Caractère converti %d\n", len);
printf("Valeur hexadécimale du premier caractère large : %#.4x\n\n", pwcs);
return(0);
}
Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :
转换为多字节字符串 被转换的字符 1 第一个多字节字符的十六进制值:0x19a60010 转换回宽字符字符串 被转换的字符 1 第一个宽字符的十六进制值:0x19a60030
Exemple 2
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>
int main() {
// Définir la locale actuelle sur celle spécifiée par la variable d'environnement de l'utilisateur
setlocale(LC_ALL, "");
// Définir une chaîne multioctet
const char *mbstr = "Hello, world!";
// Calculer la taille de tampon requise
size_t wcs_len = mbstowcs(NULL, mbstr, 0) + 1;
// Allouer un tampon de caractères larges
wchar_t *wcs = (wchar_t *)malloc(wcs_len * sizeof(wchar_t));
if (wcs == NULL) {
perror("malloc");
return 1;
}
// Effectuer la conversion
mbstowcs(wcs, mbstr, wcs_len);
// Afficher la chaîne de caractères larges
wprintf(L"%ls\n", wcs);
// libérer la mémoire
free(wcs);
return 0;
}
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>
int main() {
// Définir la locale actuelle sur celle spécifiée par la variable d'environnement de l'utilisateur
setlocale(LC_ALL, "");
// Définir une chaîne multioctet
const char *mbstr = "Hello, world!";
// Calculer la taille de tampon requise
size_t wcs_len = mbstowcs(NULL, mbstr, 0) + 1;
// Allouer un tampon de caractères larges
wchar_t *wcs = (wchar_t *)malloc(wcs_len * sizeof(wchar_t));
if (wcs == NULL) {
perror("malloc");
return 1;
}
// Effectuer la conversion
mbstowcs(wcs, mbstr, wcs_len);
// Afficher la chaîne de caractères larges
wprintf(L"%ls\n", wcs);
// libérer la mémoire
free(wcs);
return 0;
}
Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :
Hello, 世界!
Notes
- Locale: Le comportement de la fonction est affecté par le paramètre actuel
localeparamètre, généralement lors de l'appelmbstowcsDoit être appelé avantsetlocalepour définir l'élément appropriélocale。 - Gestion des erreurs: Si la chaîne multioctet d'entrée contient une séquence multioctet non valide, la fonction renvoie
(size_t)-1et définiterrno. L'appelant doit vérifier la valeur de retour et gérer les erreurs possibles. - Allocation de mémoire: L'appelant doit s'assurer
pwcsIl y a suffisamment d'espace pour stocker la chaîne de caractères larges convertie. Cela peut être fait en appelant d'abordmbstowcs, puispwcsDéfini àNULLpour calculer la taille de tampon requise.