Scroll to navigation

towupper(3) Library Functions Manual towupper(3)

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.

ATTRIBUTE

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

Schnittstelle Attribut Wert
towupper() Multithread-Fähigkeit MT-Sicher locale
towupper_l() Multithread-Fähigkeit MT-Sicher

STANDARDS

C11, POSIX.1-2008 (XSI).
POSIX.1-2008.

GESCHICHTE

C99, POSIX.1-2001 (XSI). Veraltet in POSIX.1-2008 (XSI).
POSIX.1-2008. Glibc 2.3.

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 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.

2. Mai 2024 Linux man-pages (unveröffentlicht)