toupper(3) Library Functions Manual toupper(3) BEZEICHNUNG toupper, tolower, toupper_l, tolower_l - Klein- oder Grossschreibung konvertieren BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int toupper(int c); int tolower(int c); int toupper_l(int c, locale_t locale); int tolower_l(int c, locale_t locale); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): toupper_l(), tolower_l(): Seit Glibc 2.10: _XOPEN_SOURCE >= 700 Vor Glibc 2.10: _GNU_SOURCE BESCHREIBUNG Diese Funktionen konvertieren klein geschriebene Buchstaben in gross geschriebene und umgekehrt. Wenn c ein Kleinbuchstabe ist, gibt toupper() den entsprechenden Grossbuchstaben zuruck, sofern ein solcher Grossbuchstabe in der aktuellen Locale existiert. Anderenfalls wird c zuruckgegeben. Die Funktion toupper_l() fuhrt die gleiche Aufgabe aus, aber verwendet die Locale, die durch das Locale-Handle locale angegeben wird. Wenn c ein Grossbuchstabe ist, gibt tolower() den entsprechenden Kleinbuchstaben zuruck, sofern ein solcher Kleinbuchstabe in der aktuellen Locale existiert. Anderenfalls wird c zuruckgegeben. Die Funktion tolower_l() fuhrt die gleiche Aufgabe aus, aber verwendet die Locale, die durch das Locale-Handle locale angegeben wird. Wenn c kein unsigned char-Wert oder EOF ist, ist das Verhalten dieser Funktionen nicht definiert. Das Verhalten von toupper_l() und tolower_l() ist nicht definiert, wenn locale das spezielle Locale-Objekt LC_GLOBAL_LOCALE ist (siehe duplocale(3)) oder kein gultiges Locale-Objekt-Handle ist. RUCKGABEWERT Der Ruckgabewert ist der Wert des konvertierten Buchstabens oder c, falls keine Konvertierung moglich ist. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |toupper(), tolower(), | Multithread-Fahigkeit | MT-Sicher | |toupper_l(), tolower_l() | | | +--------------------------------+-------------------------+-----------+ STANDARDS toupper() tolower() C11, POSIX.1-2008. toupper_l() tolower_l() POSIX.1-2008. GESCHICHTE toupper() tolower() C89, 4.3BSD, POSIX.1-2001. toupper_l() tolower_l() POSIX.1-2008. ANMERKUNGEN 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. 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. Was genau einen Gross- und Kleinbuchstaben ausmacht, hangt von der Locale ab. Beispielsweise kennt die Standard-Locale >>C<< keine Umlaute. Darum wird bei Umlauten auch keine Konvertierung vorgenommen. In manchen vom Englischen verschiedenen Locales existieren auch Kleinbuchstaben ohne zugehorigen Grossbuchstaben, z.B. das deutsche ss. SIEHE AUCH isalpha(3), newlocale(3), setlocale(3), towlower(3), towupper(3), uselocale(3), locale(7) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Markus Schmitt , Martin Eberhard Schauer , 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 toupper(3)