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;
}

Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :

Hello, 世界!

Notes

  1. Locale: Le comportement de la fonction est affecté par le paramètre actuellocaleparamètre, généralement lors de l'appelmbstowcsDoit être appelé avantsetlocalepour définir l'élément appropriélocale。
  2. 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.
  3. Allocation de mémoire: L'appelant doit s'assurerpwcsIl 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.

Bibliothèque standard C - <stdlib.h>

autres extensions