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;
}
#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
- Locale: Das Verhalten der Funktion wird durch die aktuelle
localeEinstellung beeinflusst, üblicherweise beim AufrufmbstowcsMuss vorher aufgerufen werdensetlocaleum die entsprechende Locale festzulegenlocale。 - 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. - Speicherzuweisung: Der Aufrufer muss sicherstellen
pwcsEs 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.