std::wctomb
| Definiert in Header <cstdlib> |
||
| int wctomb( char* s, wchar_t wc ); |
||
Wandelt ein Weitzeichen wc in eine Multibyte-Codierung um und speichert es (einschließlich etwaiger Shift-Sequenzen) in dem Zeichenarray, dessen erstes Element von s gezeigt wird. Es werden nicht mehr als MB_CUR_MAX Zeichen gespeichert. Die Konvertierung wird von der LC_CTYPE-Kategorie des aktuellen Locales beeinflusst.
Wenn wc das Nullzeichen ist, wird das Nullbyte in s geschrieben, dem jede Shift-Sequenz vorangestellt ist, die zur Wiederherstellung des anfänglichen Shift-Zustands erforderlich ist.
Wenn s ein Nullzeiger ist, wird der globale Konvertierungszustand zurückgesetzt und ermittelt, ob Umschaltsequenzen verwendet werden.
Inhalt |
[bearbeiten] Parameter
| s | - | Zeiger auf das Zeichenarray für die Ausgabe |
| wc | - | Weitzeichen, das konvertiert werden soll |
[bearbeiten] Rückgabewert
Wenn s kein Nullzeiger ist, wird die Anzahl der Bytes zurückgegeben, die in der Multibyte-Repräsentation von wc enthalten sind, oder -1, wenn wc kein gültiges Zeichen ist.
Wenn s ein Nullzeiger ist, wird sein interner Konvertierungszustand zurückgesetzt, um den anfänglichen Umschaltzustand darzustellen, und gibt 0 zurück, wenn die aktuelle Multibyte-Kodierung nicht zustandsabhängig ist (keine Umschaltsequenzen verwendet) oder einen Wert ungleich Null, wenn die aktuelle Multibyte-Kodierung zustandsabhängig ist (Umschaltsequenzen verwendet).
[bearbeiten] Hinweise
Jeder Aufruf von wctomb aktualisiert den internen globalen Konvertierungszustand (ein statisches Objekt vom Typ std::mbstate_t, nur dieser Funktion bekannt). Wenn die Multibyte-Codierung Shift-Zustände verwendet, ist diese Funktion nicht reentrant. Auf jeden Fall sollten mehrere Threads wctomb nicht ohne Synchronisation aufrufen: std::wcrtomb kann stattdessen verwendet werden.
[bearbeiten] Beispiel
#include <clocale> #include <cstdlib> #include <iomanip> #include <iostream> #include <string> void print_wide(const std::wstring& wstr) { bool shifts = std::wctomb(nullptr, 0); // reset the conversion state std::cout << "shift sequences are " << (shifts ? "" : "not" ) << " used\n" << std::uppercase << std::setfill('0'); for (const wchar_t wc : wstr) { std::string mb(MB_CUR_MAX, '\0'); const int ret = std::wctomb(&mb[0], wc); const char* s = ret > 1 ? "s" : ""; std::cout << "multibyte char '" << mb << "' is " << ret << " byte" << s << ": [" << std::hex; for (int i{0}; i != ret; ++i) { const int c = 0xFF & mb[i]; std::cout << (i ? " " : "") << std::setw(2) << c; } std::cout << "]\n" << std::dec; } } int main() { std::setlocale(LC_ALL, "en_US.utf8"); // UTF-8 narrow multibyte encoding std::wstring wstr = L"z\u00df\u6c34\U0001d10b"; // or L"zß水𝄋" print_wide(wstr); }
Ausgabe
shift sequences are not used multibyte char 'z' is 1 byte: [7A] multibyte char 'ß' is 2 bytes: [C3 9F] multibyte char '水' is 3 bytes: [E6 B0 B4] multibyte char '𝄋' is 4 bytes: [F0 9D 84 8B]
[bearbeiten] Siehe auch
| konvertiert das nächste Multibyte-Zeichen in ein Wide-Zeichen (Funktion) | |
| konvertiert ein Wide-Zeichen in seine Multibyte-Darstellung, gegeben den Zustand (Funktion) | |
| [virtuell] |
konvertiert eine Zeichenkette von InternT nach ExternT, z. B. beim Schreiben in eine Datei(virtual protected member function of std::codecvt<InternT,ExternT,StateT>) |
| C-Dokumentation für wctomb
| |
