TOUPPER(3)

BEZEICHNUNG
toupper, tolower, toupper_l, tolower_l - Klein- oder Großschreibung konvertieren

ÜBERSICHT
#include <ctype.h>

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 Makros (siehe feature_test_macros(7)):

toupper_l(), tolower_l():
    Seit Glibc 2.10:
        _XOPEN_SOURCE >= 700
    Bis Glibc 2.10:
        _GNU_SOURCE

BESCHREIBUNG
Diese Funktionen konvertieren klein geschriebene Buchstaben in groß geschriebene und umgekehrt. Wenn c ein Kleinbuchstabe ist, gibt toupper() den entsprechenden Großbuchstaben zurück, sofern ein solcher Großbuchstabe in der aktuellen Locale existiert. Anderenfalls wird c zurückgegeben. Die Funktion toupper_l() führt die gleiche Aufgabe aus, aber verwendet die Locale, die durch das Locale-Handle locale angegeben wird. Wenn c ein Großbuchstabe ist, gibt tolower() den entsprechenden Kleinbuchstaben zurück, sofern ein solcher Kleinbuchstabe in der aktuellen Locale existiert. Anderenfalls wird c zurückgegeben. Die Funktion tolower_l() führt 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 gültiges Locale-Objekt-Handle ist.

RÜCKGABEWERT
Der Rückgabewert ist der Wert des konvertierten Buchstabens oder c, falls keine Konvertierung möglich ist.

ATTRIBUTE

  Multithreading (siehe pthreads(7))
Die Funktionen toupper() und tolower() sind mit Einschränkungen multithread-fähig. Sie können sicher in Multithread-Anwendungen benutzt werden, so lange setlocale(3) nicht aufgerufen wird, um die Locale während ihrer Ausführung zu ändern.

KONFORM ZU
toupper(), tolower(): C89, C99, 4.3BSD, POSIX.1-2001, POSIX.1-2008. toupper_l(), tolower_l(): POSIX.1-2008.

ANMERKUNGEN
Was genau einen Groß- und Kleinbuchstaben ausmacht, hängt 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 zugehörigen Großbuchstaben, z.B. das deutsche ß.

SIEHE AUCH
isalpha(3), newlocale(3), setlocale(3), uselocale(3), towlower(3), towupper(3), locale(7)

KOLOPHON
This page is part of release 3.70 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt <fw@math.uni-sb.de>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> 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 <debian-l10n-german@lists.debian.org>.