BEZEICHNUNG

       towupper, towupper_l - konvertiert ein weites Zeichen in Großschreibung

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <wctype.h>

       wint_t towupper(wint_t wz);
       wint_t towupper_l(wint_t wz, locale_t locale);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       towupper_l():
           Seit Glibc 2.10:
               _XOPEN_SOURCE >= 700
           Vor Glibc 2.10:
               _GNU_SOURCE

BESCHREIBUNG

       Die  Funktion  towupper()  ist  das  Äquivalent der Funktion toupper(3) für weite Zeichen.
       Falls wz ein weites  Kleinbuchstabenzeichen  ist  und  es  in  der  aktuellen  Locale  ein
       großgeschriebenes  Äquivalent  gibt,  liefert  es  das Äquivalent von wz in Großschreibung
       zurück. In allen anderen Fällen wird wz unverändert zurückgegeben.

       Die Funktion  towupper_l()  erledigt  die  gleiche  Aufgabe,  führt  die  Umwandlung  aber
       basierend auf der Zeichentypinformation in der durch locale festgelegten Locale durch. Das
       Verhalten von towupper_l() ist  undefiniert,  falls  locale  das  besondere  Locale-Objekt
       LC_GLOBAL_LOCALE (siehe duplocale(3)) oder keine gültige Locale-Objekt-Referenz ist.

       Das  Argument  wz muss als wchar_t darstellbar und ein gültiges Zeichen in der Locale oder
       WEOF sein.

RÜCKGABEWERT

       Falls  die  Umwandlung  von  wz  in  Großschreibung  möglich  war,  liefert  towupper  das
       Großschreibungs-Äquivalent zurück, ansonsten wz.

VERSIONEN

       Die Funktion towupper_l() erschien erstmalig in Glibc 2.3.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌────────────────────────────────────────────────┬───────────────────────┬────────────────┐
       │Schnittstelle                                   │ Attribut              │ Wert           │
       ├────────────────────────────────────────────────┼───────────────────────┼────────────────┤
       │towupper()                                      │ Multithread-Fähigkeit │ MT-Safe locale │
       ├────────────────────────────────────────────────┼───────────────────────┼────────────────┤
       │towupper_l()                                    │ Multithread-Fähigkeit │ MT-Safe        │
       └────────────────────────────────────────────────┴───────────────────────┴────────────────┘

STANDARDS

       towupper():  C99,  POSIX.1-2001 (XSI); in POSIX.1-2008 als XSI-Erweiterung vorhanden, aber
       als veraltet markiert.

       towupper_l(): POSIX.1-2008.

ANMERKUNGEN

       Das Verhalten dieser Funktionen hängt von der Kategorie LC_CTYPE der Locale ab.

       Diese Funktionen sind für den Umgang mit Unicode-Zeichen nicht sehr geeignet,  da  Unicode
       über drei Groß-/Kleinschreibungsfälle verfügt: Groß, Klein und Titel.

SIEHE AUCH

       iswupper(3), towctrans(3), towlower(3), locale(7)

Ü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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.