std::mbstowcs

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Null-terminierte Multibyte-Strings

Funktionen Prüfung von Wide/Multibyte-Zeichen mblen mbrlen mbsinit Multibyte/Wide-Konvertierungen mbtowc mbstowcs btowc mbrtowc mbsrtowcs    wctomb wcstombs wctob wcrtomb wcsrtombs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11) c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11)

Typen

mbstate_t

Makros

MB_LEN_MAX MB_CUR_MAX __STDC_UTF_16__ __STDC_UTF_32__ (C++11)(C++11)

 

Definiert in Header <cstdlib>
std::size_t mbstowcs( wchar_t* dst, const char* src, std::size_t len );

Konvertiert eine Multibyte-Zeichenkette aus dem Array, dessen erstes Element von src gezeigt wird, in ihre Wide-Character-Darstellung. Konvertierte Zeichen werden in den aufeinanderfolgenden Elementen des Arrays gespeichert, auf das dst zeigt. Es werden nicht mehr als len Wide-Characters in das Zielarray geschrieben.

Jedes Zeichen wird konvertiert, als ob es durch einen Aufruf von std::mbtowc erfolgen würde, mit der Ausnahme, dass der mbtowc-Konvertierungsstatus nicht beeinflusst wird. Die Konvertierung stoppt, wenn

• Das Multibyte-Nullzeichen konvertiert und gespeichert wurde.
• Ein ungültiges (in der aktuellen C-Locale) Multibyte-Zeichen angetroffen wurde.
• Das nächste zu speichernde Wide-Character len überschreiten würde.

Hinweise

In den meisten Implementierungen aktualisiert diese Funktion ein globales statisches Objekt vom Typ std::mbstate_t, während sie die Zeichenkette durchläuft. Sie kann nicht gleichzeitig von zwei Threads aufgerufen werden. In solchen Fällen sollte std::mbsrtowcs verwendet werden.

POSIX spezifiziert eine übliche Erweiterung: Wenn dst ein Nullzeiger ist, gibt diese Funktion die Anzahl der Wide-Characters zurück, die in dst konvertiert würden. Ein ähnliches Verhalten ist Standard für std::mbsrtowcs.

Parameter

dst	-	Zeiger auf das Wide-Character-Array, in dem der Wide-String gespeichert wird
src	-	Zeiger auf das erste Element einer nullterminierten Multibyte-Zeichenkette zur Konvertierung
len	-	Anzahl der Wide-Characters, die im von dst gezeigten Array verfügbar sind

Rückgabewert

Bei Erfolg wird die Anzahl der Wide-Characters zurückgegeben, die in das Zielarray geschrieben wurden, exklusive des abschließenden L'\0'.

Bei einem Konvertierungsfehler (wenn ein ungültiges Multibyte-Zeichen angetroffen wurde) wird static_cast<std::size_t> (-1) zurückgegeben.

Beispiel

Führen Sie diesen Code aus

#include <clocale>
#include <cstdlib>
#include <iostream>
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    const char* mbstr = "z\u00df\u6c34\U0001f34c"; // or u8"zß水🍌"
                        // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";
    wchar_t wstr[5];
    std::mbstowcs(wstr, mbstr, 5);
    std::wcout << "wide string: " << wstr << '\n';
}

Ausgabe

wide string: zß水🍌

Siehe auch

mbsrtowcs	konvertiert einen schmalen Multibyte-Zeichenstring in einen Wide-String, gegeben den Zustand (Funktion)
wcstombs	konvertiert einen Wide-String in einen schmalen Multibyte-Zeichenstring (Funktion)
do_in [virtuell]	konvertiert eine Zeichenkette von ExternT nach InternT, z. B. beim Lesen aus einer Datei (virtual protected member function of std::codecvt<InternT,ExternT,StateT>)
C-Dokumentation für mbstowcs