std::mbrtowc

 

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 <cwchar>
std::size_t mbrtowc( wchar_t* pwc,                      const char* s,                      std::size_t n,                      std::mbstate_t* ps );

Konvertiert ein schmales Multibyte-Zeichen in ein breites Zeichen.

Wenn s kein Null-Zeiger ist, werden höchstens n Bytes des Multibyte-Zeichenstrings inspiziert, beginnend mit dem Byte, auf das s zeigt, um die Anzahl der Bytes zu ermitteln, die zur Vervollständigung des nächsten Multibyte-Zeichens (einschließlich etwaiger Verschiebesequenzen) erforderlich sind. Wenn die Funktion feststellt, dass das nächste Multibyte-Zeichen in s vollständig und gültig ist, konvertiert sie es in das entsprechende breite Zeichen und speichert es in *pwc (falls pwc nicht null ist).

Wenn s ein Null-Zeiger ist, werden die Werte von n und pwc ignoriert und der Aufruf ist äquivalent zu std::mbrtowc(nullptr, "", 1, ps).

Wenn das erzeugte breite Zeichen das Nullzeichen ist, ist der in *ps gespeicherte Konvertierungszustand der initiale Verschiebezustand.

Parameter

pwc	-	Zeiger auf die Stelle, an der das resultierende breite Zeichen geschrieben wird
s	-	Zeiger auf den Mehrbyte-Zeichenstring, der als Eingabe verwendet wird
n	-	Grenze für die Anzahl der Bytes in s, die untersucht werden können
ps	-	Zeiger auf den Konvertierungszustand, der bei der Interpretation des Multibyte-Strings verwendet wird

Rückgabewert

Das erste der folgenden zutreffenden Elemente

• ​0​, wenn das aus s konvertierte Zeichen (und, falls nicht null, in pwc gespeichert) das Nullzeichen war.
• Die Anzahl der Bytes [1...n] des Mehrbyte-Zeichens, das erfolgreich aus s konvertiert wurde.
• static_cast<std::size_t>(-2), wenn die nächsten n Bytes ein unvollständiges, aber bisher gültiges Multibyte-Zeichen darstellen. Es wird nichts in *pwc geschrieben.
• static_cast<std::size_t>(-1), wenn ein Kodierungsfehler auftritt. Es wird nichts in *pwc geschrieben, der Wert EILSEQ wird in errno gespeichert und der Wert von *ps bleibt undefiniert.

Beispiel

Führen Sie diesen Code aus

#include <clocale>
#include <cstring>
#include <cwchar>
#include <iostream>
 
void print_mb(const char* ptr)
{
    std::mbstate_t state = std::mbstate_t(); // initial state
    const char* end = ptr + std::strlen(ptr);
    int len;
    wchar_t wc;
    while ((len = std::mbrtowc(&wc, ptr, end-ptr, &state)) > 0)
    {
        std::wcout << "Next " << len << " bytes are the character " << wc << '\n';
        ptr += len;
    }
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const char* str = "z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                      // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    print_mb(str);
}

Ausgabe

Next 1 bytes are the character z
Next 2 bytes are the character ß
Next 3 bytes are the character 水
Next 4 bytes are the character 𝄋

Siehe auch

mbtowc	konvertiert das nächste Multibyte-Zeichen in ein Wide-Zeichen (Funktion)
wcrtomb	konvertiert ein Wide-Zeichen in seine Multibyte-Darstellung, gegeben den Zustand (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 mbrtowc