mblen(3) Library Functions Manual mblen(3) BEZEICHNUNG mblen - Bestimmen der Anzahl der Bytes im nachsten Multibyte-Zeichen BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int mblen(size_t n; const char s[n], size_t n); BESCHREIBUNG Falls z nicht NULL ist, untersucht die Funktion mblen() hochstens n byte der bei z beginnenden Multibyte-Zeichenkette und lost das nachste Multibyte-Zeichen heraus. Es verwendet einen statischen anonymen Verschiebe-Zustand, der nur der Funktion mblen() bekannt ist. Falls das Multibyte-Zeichen nicht das weite Nullzeichen ist, liefert es die Anzahl der Bytes zuruck, die aus z verbraucht wurden. Falls das Multibyte-Zeichen das weite Nullzeichen ist, liefert sie 0 zuruck. Falls die bei z beginnenden n byte kein vollstandiges Multibyte-Zeichen enthalten, liefert mblen() -1 zuruck. Das kann selbst dann passieren, falls n grosser oder gleich MB_CUR_MAX ist, falls die Multibyte-Zeichenkette redundante Verschiebesequenzen enthalt. Falls die bei z beginnende Zeichenkette eine ungultige Multibytesequenz vor dem nachsten vollstandigen Zeichen enthalt, liefert mblen() auch -1 zuruck. Falls z NULL ist, setzt mblen() den nur dieser Funktion bekannten Schiebe-Zustand auf den anfanglichen Zustand zuruck und liefert einen von Null verschiedenen Wert zuruck, falls die Kodierung einen nicht trivialen Schiebe-Zustand hat oder Null, falls die Kodierung zustandsfrei ist. RUCKGABEWERT Die Funktion mblen() liefert die Anzahl der aus der bei z beginnenden Multibyte-Sequenz ausgewerteten Bytes zuruck, falls ein von Null verschiedenes weites Zeichen erkannt wurde. Sie liefert 0 zuruck, falls ein weites Nullzeichen erkannt wurde. Sie liefert -1 zuruck, falls eine ungultige Multibyte-Sequenz angetroffen wurde oder sie kein vollstandiges Multibyte-Zeichen auswerten konnte. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-------------------------+-------------------------+------------------+ |Schnittstelle | Attribut | Wert | +-------------------------+-------------------------+------------------+ |mblen() | Multithread-Fahigkeit | MT-Unsicher race | +-------------------------+-------------------------+------------------+ VERSIONEN Die Funktion mbrlen(3) stellt eine bessere Schnittstelle fur die gleiche Funktionalitat bereit. STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Das Verhalten von mblen() hangt von der Kategorie LC_CTYPE der aktuellen Locale ab. SIEHE AUCH mbrlen(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.18 8. Februar 2026 mblen(3)