Fonctions de la bibliothèque C -mbtowc()

Bibliothèque standard C - <stdlib.h>

mbtowc()C'est une fonction de la bibliothèque standard C qui convertit un caractère multioctet en un caractère large.

mbtowc()La déclaration se trouve dans<wchar.h>Dans le fichier d'en-tête, elle est principalement utilisée pour prendre en charge la conversion entre des jeux de caractères multioctets (tels que UTF-8) et des jeux de caractères larges (tels que Unicode).

mbtowc()Utilisée pour convertir un caractère multioctet (mbstr) en un caractère large (wc). Cette fonction est basée sur laLC_CTYPELa locale (paramètres d'environnement) détermine comment les caractères multioctets sont interprétés. Si le caractère multioctet est valide, il est converti en un caractère large. Si le caractère est invalide, elle renvoie-1。

Déclaration

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

#include <wchar.h>

int mbtowc(wchar_t *wc, const char *mbstr, size_t n);

Paramètres :

  • wc: pointe verswchar_tUn pointeur vers une variable du type. Cette variable recevra le caractère large converti.
  • mbstr: un pointeur vers la chaîne multioctet, qui est la séquence de caractères multioctets à convertir.
  • n: indiquembstrLe nombre maximal d'octets dans la chaîne. En général, vous pouvez le définir sur la longueur de la chaîne.

Valeur de retour

  • Si l'opération réussit,mbtowc()Renvoie le nombre d'octets occupés par le caractère converti (c'est-à-dirembstrle nombre d'octets du caractère multioctet). Siwcn'est pasNULL, alors la valeur est supérieure à 0.
  • Si une erreur est rencontrée (comme un caractère multioctet non valide), la fonction renvoie-1。
  • Si la fin de la séquence de caractères est atteinte (par exemple, en rencontrant le terminateur de chaîne\0), alors renvoie0。

Exemple

L'exemple suivant illustre l'utilisation de la fonction mbtowc().

Exemple

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <wchar.h>
#include <locale.h>

int main()
{
    // Définir les informations de locale du programme
    setlocale(LC_CTYPE, "");

    // Chaîne multi-octets
    const char *str = "Here is example.com";

    // Tableau de caractères larges pour stocker le résultat converti
    wchar_t mb[100];
   
    // Index du caractère actuel et longueur convertie en caractères larges
    int i = 0;
    int len;
   
    // Convertir chaque caractère en caractère large
    while (*str) {
        len = mbtowc(&mb[i], str, MB_CUR_MAX);  // Convertir le caractère multi-octets actuel
        if (len > 0) {
            str += len;  // Se déplacer au début du caractère suivant
            i++;  // Stocker dans le tableau de caractères larges
        } else if (len == 0) {
            break;  // Terminateur de chaîne rencontré
        } else {
            // Gestion des erreurs pour caractère non valide
            printf("Caractère non valide\n");
            break;
        }
    }

    // Afficher la chaîne de caractères larges convertie
    wprintf(L"%ls \n", mb);
   
    return 0;
}

Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant, car il doit produire le résultat sous forme multioctet, qui est une sortie binaire.

这里是 example.com 

Exemple

#include <stdio.h>
#include <wchar.h>
#include <locale.h>

int main() {
    // Définir les informations de locale du programme
    setlocale(LC_CTYPE, "");

    const char *mbstr = Hello;
    wchar_t wc;

    // Convertir caractère par caractère
    for (size_t i = 0; mbstr[i] != '\0'; i++) {
        int len = mbtowc(&wc, &mbstr[i], 1);
        if (len > 0) {
            wprintf(L"Caractère large converti : %lc\n", wc);
            i += len - 1;  // Sauter le nombre d'octets du caractère multioctet actuel
        } else if (len == 0) {
            break;
        } else {
            printf("Caractère non valide\n");
        }
    }

    return 0;
}

Description:

  1. Jeu de caractères multioctets: Dans un jeu de caractères multioctets (comme UTF-8), un caractère peut être composé de plusieurs octets, tandis qu'un caractère dans un jeu de caractères larges (comme Unicode) est généralement représenté par une seulewchar_tvaleur du type (2 ou 4 octets sur certaines plateformes).

  2. Paramètres régionaux:mbtowc()Son comportement dépend des paramètres régionaux du programme actuel, en particulierLC_CTYPEle paramètre régional, qui détermine comment le jeu de caractères multioctets est interprété. Par conséquent, lorsque vous utilisez cette fonction, vous devez généralement utilisersetlocale()Définir les paramètres régionaux appropriés.

  3. Gestion des erreurs: Si la chaîne multioctets d'entrée n'est pas dans un format valide, ou ne peut pas être convertie en un caractère large,mbtowc()renverra-1. Vous devez vérifier la valeur de retour pour vous assurer que la conversion est réussie.

Bibliothèque standard C - <stdlib.h>

autres extensions