C-Bibliotheksfunktionen -mbstowcs()

C-Standardbibliothek - <stdlib.h>

Beschreibung

C-BibliotheksfunktionenmbstowcsWird verwendet, um eine Multibyte-Zeichenfolge in eine Wide-Character-Zeichenfolge umzuwandeln.

mbstowcsDie Funktion ist in der Header-Datei <stdlib.h> definiert.

Deklaration

Nachfolgend ist die Deklaration der Funktion mbstowcs() angegeben.

size_t mbstowcs(wchar_t *pwcs, const char *mbs, size_t n);

Parameter

  • pwcs: Zeigt auf einen Puffer, der zum Speichern der konvertierten Wide-Character-Zeichenfolge verwendet wird. WennpwcsNULL ist, gibt die Funktion die erforderliche Pufferlänge zurück, ohne die eigentliche Konvertierung durchzuführen.
  • mbs: Zeiger auf eine Multibyte-Zeichenfolge.
  • n: Die maximale Anzahl der zu konvertierenden Zeichen. Wenn, bevor das abschließende Zeichen angetroffen wird, die Konvertierung bereits durchgeführt wurdenZeichen, wird die Konvertierung vorzeitig beendet.

Rückgabewert

  • Bei Erfolg gibt sie die Anzahl der konvertierten Breitzeichen zurück, ohne das abschließende Nullzeichen.
  • Wenn eine ungültige Multibyte-Sequenz auftritt, gibt sie zurück(size_t)-1, und setzterrno。

Beispiel

Das folgende Beispiel demonstriert die Verwendung der Funktion mbstowcs().

Beispiel 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("In eine Multibyte-Zeichenkette konvertieren\n"); len = wcstombs( pmb, pwc, MB_CUR_MAX); printf("Konvertiertes Zeichen %d\n", len); printf("Hexadezimalwert des ersten Multibyte-Zeichens: %#.4x\n", pmb); printf("Zurück in eine Breitzeichen-Zeichenkette konvertieren\n"); len = mbstowcs( pwcs, pmb, MB_CUR_MAX); printf("Konvertiertes Zeichen %d\n", len); printf("Hexadezimalwert des ersten Breitzeichens: %#.4x\n\n", pwcs); return(0); }

Lassen Sie uns das obige Programm kompilieren und ausführen, was das folgende Ergebnis erzeugt:

转换为多字节字符串
被转换的字符 1
第一个多字节字符的十六进制值:0x19a60010
转换回宽字符字符串
被转换的字符 1
第一个宽字符的十六进制值:0x19a60030

Beispiel 2

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

int main() {
    // Aktuelle Locale auf die durch die Benutzerumgebungsvariable angegebene Locale setzen
    setlocale(LC_ALL, "");

    // Eine Multibyte-Zeichenkette definieren
    const char *mbstr = "Hello, world!";
    // Erforderliche Puffergröße berechnen
    size_t wcs_len = mbstowcs(NULL, mbstr, 0) + 1;

    // Breitzeichenpuffer reservieren
    wchar_t *wcs = (wchar_t *)malloc(wcs_len * sizeof(wchar_t));
    if (wcs == NULL) {
        perror("malloc");
        return 1;
    }

    // Konvertierung durchführen
    mbstowcs(wcs, mbstr, wcs_len);

    // Breitzeichenkette ausgeben
    wprintf(L"%ls\n", wcs);

    // Speicher freigeben
    free(wcs);

    return 0;
}

Lassen Sie uns das obige Programm kompilieren und ausführen, was das folgende Ergebnis erzeugt:

Hello, 世界!

Hinweise

  1. Locale: Das Verhalten der Funktion wird durch die aktuellelocaleEinstellung beeinflusst, üblicherweise beim AufrufmbstowcsMuss vorher aufgerufen werdensetlocaleum die entsprechende Locale festzulegenlocale。
  2. Fehlerbehandlung: Wenn die eingegebene Multibyte-Zeichenkette eine ungültige Multibyte-Sequenz enthält, gibt die Funktion(size_t)-1zurück und setzterrno. Der Aufrufer muss den Rückgabewert prüfen und mögliche Fehler behandeln.
  3. Speicherzuweisung: Der Aufrufer muss sicherstellenpwcsEs ist genügend Speicherplatz vorhanden, um die konvertierte Wide-Character-Zeichenkette zu speichern. Dies kann erreicht werden, indem zuerstmbstowcs, dannpwcsSetzen aufNULLaufgerufen wird, um die erforderliche Puffergröße zu berechnen.

C-Standardbibliothek - <stdlib.h>

Weitere Erweiterungen