mbrlen(3) Library Functions Manual mbrlen(3) BEZEICHNUNG mbrlen - Die Anzahl der Bytes im nachsten Multibytezeichen ermitteln BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include size_t mbrlen(const char z[restrict .n], size_t n, mbstate_t *restrict ps); BESCHREIBUNG Die Funktion mbrlen() untersucht hochstens n byte der bei z beginnenden Multibytezeichenkette und lost das nachste vollstandige Multibytezeichen aus. Es aktualisiert den Schiebe-Zustand *ps. Falls das Multibytezeichen nicht das weite Nullzeichen ist, liefert es die Anzahl der Bytes zuruck, die aus z verbraucht wurden. Falls das Multibytezeichen das weite Nullzeichen ist, setzt es den Schiebe-Zustand *ps auf den anfanglichen Zustand zuruck und liefert 0 zuruck. Falls die n bei z beginnenden Bytes kein vollstandiges Mulitbytezeichen enthalten, liefert mbrlen() (size_t) -2 zuruck. Dies kann passieren, selbst wenn n >= MB_CUR_MAX, falls die Multibytezeichenkette redundante Schiebesequenzen enthalt. Falls die bei z beginnende Multibytezeichenkette eine ungultige Multibytesequenz vor dem nachsten vollstandigen Zeichen enthalt, liefert mbrlen() (size_t) -1 zuruck und setzt errno auf EILSEQ. In diesem Fall sind die Auswirkungen auf *ps nicht definiert. Falls ps NULL ist, wird stattdessen eine anonyme statische, nur mbrlen() bekannte Funktion verwandt. RUCKGABEWERT Die Funktion mbrlen() 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 (size_t) -1 zuruck und setzt errno auf EILSEQ, falls eine ungultige Multibyte-Sequenz angetroffen wurde. Sie liefert (size_t) -2 zuruck, falls sie kein vollstandiges Multibytezeichen auswerten konnte, was bedeutet, dass n erhoht werden sollte. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------+-------------------------+-----------------------------+ |Schnittstelle | Attribut | Wert | +--------------+-------------------------+-----------------------------+ |mbrlen() | Multithread-Fahigkeit | MT-Unsicher race:mbrlen/!ps | +--------------+-------------------------+-----------------------------+ STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Das Verhalten von mbrlen() hangt von der Kategorie LC_CTYPE der aktuellen Locale ab. SIEHE AUCH mbrtowc(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.8 2. Mai 2024 mbrlen(3)