mbtowc(3) Library Functions Manual mbtowc(3) BEZEICHNUNG mbtowc - Eine Multibyte-Sequenz in ein weites Zeichen umwandeln BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int mbtowc(wchar_t *restrict zwz, const char s[restrict .n], size_t n); BESCHREIBUNG Der Haupteinsatzfall fur diese Funktion ist, wenn s und zwz nicht NULL sind. In diesem Fall untersucht die Funktion mbtowc() hochstens n byte einer bei s beginnenden Multibyte-Zeichenkette, extrahiert das nachste vollstandige Multibyte-Zeichen, wandelt es in ein weites Zeichen um und speichert es unter *zwz. Es aktualisiert den nur der Funktion mbtowc() bekannten internen Verschiebezustand. Falls s nicht auf ein Null-Byte (>>\0<<) zeigt, liefert es die Anzahl der Byte zuruck, die von s verbraucht wurden, andernfalls liefert sie 0 zuruck. Falls die n bei s beginnenden Byte kein vollstandiges Multibyte-Zeichen oder eine ungultige Multibyte-Sequenz enthalten, liefert mbtowc() -1 zuruck. Dies kann passieren, selbst wenn n >= MB_CUR_MAX, falls die Multibyte-Sequenz redundante Verschiebezustande enthalt. Ein anderer Fall liegt vor, wenn s nicht NULL ist, aber zwz NULL ist. In diesem Fall verhalt sich die Funktion mbtowc() wie oben, ausser dass sie die umgewandelten weiten Zeichen nicht im Speicher speichert. Ein dritter Fall liegt vor, wenn s NULL ist. In diesem Fall werden zwz und n ignoriert. Die Funktion mbtowc() setzt den nur ihr bekannten internen Verschiebezustand auf den Anfangszustand zuruck und liefert einen von Null verschiedenen Wert zuruck, falls die Kodierung einen nicht trivialen Verschiebezustand enthalt oder Null, falls die Kodierung zustandslos ist. RUCKGABEWERT Falls s nicht NULL ist, dann liefert die Funktion mbtowc() die Anzahl der bei s beginnenden verbrauchten Byte oder 0, falls s auf ein Null-Byte zeigt oder -1 im Fehlerfall, zuruck. Falls s NULL ist, dann liefert die Funktion mbtowc() einen von Null verschiedenen Wert zuruck, falls die Kodierung einen nicht trivialen Verschiebezustand hat oder Null, falls die Kodierung zustandslos ist. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-------------------------+-------------------------+------------------+ |Schnittstelle | Attribut | Wert | +-------------------------+-------------------------+------------------+ |mbtowc() | Multithread-Fahigkeit | MT-Unsicher race | +-------------------------+-------------------------+------------------+ VERSIONEN Diese Funktion ist nicht Multithread-sicher. Die Funktion mbrtowc(3) stellt eine bessere Schnittstelle fur die gleiche Funktionalitat bereit. STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Das Verhalten von mbtowc() hangt von der Kategorie LC_CTYPE der aktuellen Locale ab. SIEHE AUCH MB_CUR_MAX(3), mblen(3), mbrtowc(3), mbstowcs(3), wcstombs(3), wctomb(3) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.12 23. Juli 2024 mbtowc(3)