conv(3C) conv(3C)
NAME
conv: toupper, tolower, toupper, tolower, toascii, towlower,
towupper - Zeichen umwandeln
SYNTAX
#include <ctype.h>
int toupper(int c);
int tolower(int c);
int toupper(int c);
int tolower(int c);
int toascii(int c);
#include <wctype.h>
wintt towlower(wint wc);
wintt towupper(wint wc);
BESCHREIBUNG
toupper() und tolower() haben denselben Definitions- und Wertebereich
wie getc(3S): Alle Werte, die als unsigned char dargestellt werden und
der Wert des Makros EOF, wie er in stdio.h definiert ist. Wenn das
Argument von toupper() einen Kleinbuchstaben darstellt, ist der ent-
sprechende Großbuchstabe das Ergebnis. Wenn das Argument von tolower()
einen Großbuchstaben darstellt, ist der entsprechende Kleinbuchstabe
das Ergebnis. Alle anderen Argumente des Definitionsbereichs werden
unverändert zurückgegeben.
Die Makros toupper() und tolower() haben die gleiche Wirkung wie
toupper() und tolower(). Sie weisen jedoch eingeschränkte Definitions-
bereiche auf und sind schneller. toupper() benötigt einen Kleinbuch-
staben als Argument; das Ergebnis ist der entsprechende Großbuchstabe.
Das Makro tolower() benötigt einen Großbuchstaben als Argument; das
Ergebnis ist der entsprechende Kleinbuchstabe. Außerhalb des Definiti-
onsbereichs liegende Argumente liefern undefinierte Ergebnisse.
Bei dem von toascii() gelieferten Argument sind alle Bits ausgeschal-
tet, die nicht Teil eines 7-Bit ASCII-Standardzeichens sind; dadurch
wird die Kompatibilität zu anderen Systemen erreicht.
Die Funktion towlower() liefert für einen großgeschriebenen Wide-
Character den entsprechenden kleingeschriebenen Wide-Character, wenn
es den entsprechenden Wide-Character kleingeschrieben in der Locale
gibt. Das Argument wc, das an die Funktion übergeben wird, muß mit dem
Datentyp wchart darstellbar sein und mit der aktuellen Spracheinstel-
lung oder mit WEOF übereinstimmen. Wenn wc eine dieser Bedingungen
nicht erfüllt, ist das Ergebnis der Funktion unbestimmt. Ist das
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
conv(3C) conv(3C)
übergebene Argument kein großer Wide-Character, entspricht aber dem
Zeichensatz von wchart, wird das Argument nicht umgewandelt.
Für die Funktion towupper() gelten dieselben Bedingung, nur liefert
towupper() für einen kleinen Wide-Character den entsprechenden großen,
wie in der Kategorie LCCTYPE definiert.
SIEHE AUCH
ctype(3C), setlocale(3C), getc(3S), ctype(5), wctype(5).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98