Man page - mbrlen(3)

Packages contains this manual

Available languages:

en fr es ja ru ro de

Manual

mbrlen

BEZEICHNUNG
BIBLIOTHEK
ÜBERSICHT
BESCHREIBUNG
RÜCKGABEWERT
ATTRIBUTE
STANDARDS
GESCHICHTE
ANMERKUNGEN
SIEHE AUCH
ÜBERSETZUNG

BEZEICHNUNG

mbrlen - Die Anzahl der Bytes im nÀchsten Multibytezeichen ermitteln

BIBLIOTHEK

Standard-C-Bibliothek ( libc , -lc )

ÜBERSICHT

#include <wchar.h>

size_t mbrlen(const char z [restrict . n ], size_t n ,
mbstate_t *restrict
ps );

BESCHREIBUNG

Die Funktion mbrlen () untersucht höchstens n byte der bei z beginnenden Multibytezeichenkette und löst das nĂ€chste vollstĂ€ndige Multibytezeichen aus. Es aktualisiert den Schiebe-Zustand *ps . Falls das Multibytezeichen nicht das weite Nullzeichen ist, liefert es die Anzahl der Bytes zurĂŒck, die aus z verbraucht wurden. Falls das Multibytezeichen das weite Nullzeichen ist, setzt es den Schiebe-Zustand *ps auf den anfĂ€nglichen Zustand zurĂŒck und liefert 0 zurĂŒck.

Falls die n bei z beginnenden Bytes kein vollstĂ€ndiges Mulitbytezeichen enthalten, liefert mbrlen () (size_t) -2 zurĂŒck. Dies kann passieren, selbst wenn n >= MB_CUR_MAX , falls die Multibytezeichenkette redundante Schiebesequenzen enthĂ€lt.

Falls die bei z beginnende Multibytezeichenkette eine ungĂŒltige Multibytesequenz vor dem nĂ€chsten vollstĂ€ndigen Zeichen enthĂ€lt, liefert mbrlen () (size_t) -1 zurĂŒck 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.

RÜCKGABEWERT

Die Funktion mbrlen () liefert die Anzahl der aus der bei z beginnenden Multibyte-Sequenz ausgewerteten Bytes zurĂŒck, falls ein von Null verschiedenes weites Zeichen erkannt wurde. Sie liefert 0 zurĂŒck, falls ein weites Nullzeichen erkannt wurde. Sie liefert (size_t) -1 zurĂŒck und setzt errno auf EILSEQ , falls eine ungĂŒltige Multibyte-Sequenz angetroffen wurde. Sie liefert (size_t) -2 zurĂŒck, falls sie kein vollstĂ€ndiges Multibytezeichen auswerten konnte, was bedeutet, dass n erhöht werden sollte.

ATTRIBUTE

Siehe attributes (7) fĂŒr eine ErlĂ€uterung der in diesem Abschnitt verwandten AusdrĂŒcke.

Image grohtml-1217610-1.png

STANDARDS

C11, POSIX.1-2008.

GESCHICHTE

POSIX.1-2001, C99.

ANMERKUNGEN

Das Verhalten von mbrlen () hÀngt von der Kategorie LC_CTYPE der aktuellen Locale ab.

SIEHE AUCH

mbrtowc (3)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezĂŒglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ĂŒbernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org .