isalpha(3) Library Functions Manual isalpha(3) BEZEICHNUNG isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, isalnum_l, isalpha_l, isascii_l, isblank_l, iscntrl_l, isdigit_l, isgraph_l, islower_l, isprint_l, ispunct_l, isspace_l, isupper_l, isxdigit_l - Zeichenklassifizierungs-Funktionen BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int isalnum(int c); int isalpha(int c); int iscntrl(int c); int isdigit(int c); int isgraph(int c); int islower(int c); int isprint(int c); int ispunct(int c); int isspace(int c); int isupper(int c); int isxdigit(int c); int isascii(int c); int isblank(int c); int isalnum_l(int c, locale_t locale); int isalpha_l(int c, locale_t locale); int isblank_l(int c, locale_t locale); int iscntrl_l(int c, locale_t locale); int isdigit_l(int c, locale_t locale); int isgraph_l(int c, locale_t locale); int islower_l(int c, locale_t locale); int isprint_l(int c, locale_t locale); int ispunct_l(int c, locale_t locale); int isspace_l(int c, locale_t locale); int isupper_l(int c, locale_t locale); int isxdigit_l(int c, locale_t locale); int isascii_l(int c, locale_t locale); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): isascii(): _XOPEN_SOURCE || /* Glibc >= 2.19: */ _DEFAULT_SOURCE || /* Glibc <= 2.19: */ _SVID_SOURCE isblank(): _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L salnum_l(), salpha_l(), sblank_l(), scntrl_l(), sdigit_l(), sgraph_l(), slower_l(), sprint_l(), spunct_l(), sspace_l(), supper_l(), sxdigit_l(): Seit Glibc 2.10: _XOPEN_SOURCE >= 700 Vor Glibc 2.10: _GNU_SOURCE isascii_l(): Seit Glibc 2.10: _XOPEN_SOURCE >= 700 && (_SVID_SOURCE || _BSD_SOURCE) Vor Glibc 2.10: _GNU_SOURCE BESCHREIBUNG Diese Funktionen prufen, ob c, das den Wert eines unsigned char haben oder EOF sein muss, in eine Zeichenklasse entsprechend den aktuellen Einstellungen fur die Spracheinstellung (locale) passt. Die Funktionen ohne das Suffix >>_l<< fuhren die Uberprufung basierend auf der aktuellen Locale aus. Die Funktionen mit dem Suffix >>_l<< fuhren die Uberprufung basierend auf der im Locale-Objekt locale angegebenen Locale aus. Das Verhalten dieser Funktionen ist nicht definiert, falls locale das spezielle Locale-Objekt LC_GLOBAL_LOCALE (siehe duplocale(3)) oder kein gultiges Locale-Objekt-Handle ist. die folgende Liste erlautert die Wirkungsweise der Funktionen ohne das Suffix >>_l<<. Das Verhalten der Funktionen mit dem Suffix >>_l<< unterscheidet sich davon nur dadurch, dass das Locale-Objekt locale anstelle der aktuellen Locale verwendet wird. isalnum() pruft auf alphanumerische Zeichen, es ist aquivalent zu (isalpha(c) || isdigit(c)). isalpha() pruft auf alphanumerische Zeichen, in der standard "C"-Locale ist es aquivalent zu (isupper(c) || islower(c)). In anderen Locales kann es weitere Zeichen geben, fur die isalpha() wahr ist - Zeichen, die weder Gross- noch Kleinbuchstaben sind. isascii() pruft, ob c ein 7-bit unsigned char-Wert ist, der in den ASCII-Zeichensatz passt. isblank() pruft auf ein Leerzeichen, also ein Leerzeichen oder einen Tabulator iscntrl() pruft auf ein Steuerzeichen isdigit() pruft auf eine Ziffer (0 bis 9) isgraph() pruft auf druckbare Zeichen ausser Leerzeichen islower() pruft auf einen Kleinbuchstaben isprint() pruft auf druckbare Zeichen inklusive Leerzeichen ispunct() pruft auf druckbare Zeichen, das kein Leerzeichen und kein alphanumerisches Zeichen ist isspace() pruft auf Leerraumzeichen. In den "C"- und "POSIX"-Locales sind dies: Leerzeichen, Seitenvorschub (>>\f<<), Zeilenumbruch ('\n'), Wagenrucklauf (>>\r<<), horizontaler Tabulator (>>\t<<) und vertikaler Tabulator (>>\v<<). isupper() pruft auf einen Grossbuchstaben isxdigit() pruft, auf hexadezimale Ziffern, also eine von 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F. RUCKGABEWERT Falls das Zeichen c in die geprufte Klasse fallt, wird eine Zahl ungleich null zuruckgegeben, ansonsten null. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |isalnum(), isalpha(), | Multithread-Fahigkeit | MT-Sicher | |isascii(), isblank(), | | | |iscntrl(), isdigit(), | | | |isgraph(), islower(), | | | |isprint(), ispunct(), | | | |isspace(), isupper(), | | | |isxdigit() | | | +--------------------------------+-------------------------+-----------+ STANDARDS isalnum() isalpha() iscntrl() isdigit() isgraph() islower() isprint() ispunct() isspace() isupper() isxdigit() isblank() C11, POSIX.1-2008. isascii() isalnum_l() isalpha_l() isblank_l() iscntrl_l() isdigit_l() isgraph_l() islower_l() isprint_l() ispunct_l() isspace_l() isupper_l() isxdigit_l() POSIX.1-2008. isascii_l() GNU. GESCHICHTE isalnum() isalpha() iscntrl() isdigit() isgraph() islower() isprint() ispunct() isspace() isupper() isxdigit() C89, POSIX.1-2001. isblank() C99, POSIX.1-2001. isascii() POSIX.1-2001 (XSI). POSIX.1-2008 markiert es als veraltet, daher sollte darauf hingewiesen werden, dass es in einer lokalisierten Anwendung nicht portabel verwendet werden kann. isalnum_l() isalpha_l() isblank_l() iscntrl_l() isdigit_l() isgraph_l() islower_l() isprint_l() ispunct_l() isspace_l() isupper_l() isxdigit_l() Glibc 2.3. POSIX.1-2008. isascii_l() Glibc 2.3. WARNUNGEN Die Standards verlangen, dass das Argument c fur diese Funktionen entweder EOF oder ein Wert, der in dem Typ unsigned char darstellbar ist, sein muss. Andernfalls ist das Verhalten undefiniert. Falls das Argument c vom Typ char ist, muss es in unsigned char umgewandelt werden, wie in dem folgenden Beispiel: char c; res = toupper((unsigned char) c); Dies ist notwendig, da char aquivalent zu signed char sein kann. In diesem Fall wurde ein Byte, bei dem das hochste Bit gesetzt ist, mit einem Vorzeichen erweitert, wenn es in ein int konvertiert wurde. Dies wurde zu einem Wert fuhren, der ausserhalb des Bereichs von unsigned char ware. Die Details, welche Zeichen zu welcher Klasse gehoren, sind von der Locale abhangig. Zum Beispiel wird isupper() in der Standard-C-Locale kein A als Grossbuchstaben erkennen. SIEHE AUCH iswalnum(3), iswalpha(3), iswblank(3), iswcntrl(3), iswdigit(3), iswgraph(3), iswlower(3), iswprint(3), iswpunct(3), iswspace(3), iswupper(3), iswxdigit(3), newlocale(3), setlocale(3), toascii(3), tolower(3), toupper(3), uselocale(3), ascii(7), locale(7) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann , Mario Blattermann und Dr. Tobias Quathamer 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.06 31. Oktober 2023 isalpha(3)