Imported tab->space correction by redhat
[infodrom/manpages-de] / man3 / isalpha.3
1 .\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
2 .\"
3 .\" Permission is granted to make and distribute verbatim copies of this
4 .\" manual provided the copyright notice and this permission notice are
5 .\" preserved on all copies.
6 .\"
7 .\" Permission is granted to copy and distribute modified versions of this
8 .\" manual under the conditions for verbatim copying, provided that the
9 .\" entire resulting derived work is distributed under the terms of a
10 .\" permission notice identical to this one
11 .\" 
12 .\" Since the Linux kernel and libraries are constantly changing, this
13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
14 .\" responsibility for errors or omissions, or for damages resulting from
15 .\" the use of the information contained herein.  The author(s) may not
16 .\" have taken the same level of care in the production of this manual,
17 .\" which is licensed free of charge, as they might when working
18 .\" professionally.
19 .\" 
20 .\" Formatted or processed versions of this manual, if unaccompanied by
21 .\" the source, must acknowledge the copyright and authors of this work.
22 .\" License.
23 .\"
24 .\" Modified Sat Jul 24 19:10:00 1993 by Rik Faith (faith@cs.unc.edu)
25 .\" Modified Sun Aug 21 17:51:50 1994 by Rik Faith (faith@cs.unc.edu)
26 .\" Modified Sat Sep  2 21:52:01 1995 by Jim Van Zandt <jrv@vanzandt.mv.com>
27 .\" Modified Mon May 27 22:55:26 1996 by Martin Schulze (joey@linux.de)
28 .\" Translated into german by Martin Schulze (joey@finlandia.infodrom.north.de)
29 .\"
30 .TH ISALPHA 3 "27. Mai 1996" "GNU" "Bibliotheksfunktionen"
31 .SH BEZEICHNUNG
32 isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, 
33 isprint, ispunct, isspace, isupper, isxdigit \- Zeichenklassifizierungs-Funktionen
34 .SH "ÜBERSICHT"
35 .nf
36 .B #include <ctype.h>
37 .sp
38 .BI "int isalnum (int " "c" ");"
39 .nl
40 .BI "int isalpha (int " "c" ");"
41 .nl
42 .BI "int isascii (int " "c" ");"
43 .nl
44 .BI "int isblank (int " "c" ");"
45 .nl
46 .BI "int iscntrl (int " "c" ");"
47 .nl
48 .BI "int isdigit (int " "c" ");"
49 .nl
50 .BI "int isgraph (int " "c" ");"
51 .nl
52 .BI "int islower (int " "c" ");"
53 .nl
54 .BI "int isprint (int " "c" ");"
55 .nl
56 .BI "int ispunct (int " "c" ");"
57 .nl
58 .BI "int isspace (int " "c" ");"
59 .nl
60 .BI "int isupper (int " "c" ");"
61 .nl
62 .BI "int isxdigit (int " "c" ");"
63 .fi
64 .SH BESCHREIBUNG
65 Diese Funktionen prüfen, ob das Zeichen
66 .IR c ,
67 das den Wert eines
68 .B unsigned char
69 haben oder
70 .B EOF 
71 sein muss, in eine Zeichenklasse entsprechend den aktuellen
72 Einstellungen für die Spracherweiterungen (locale)
73 passt.
74 .TP 
75 .B "isalnum()"
76 prüft auf alphanumerische Zeichen, es ist äquivalent zu
77 .BI "(isalpha(" c ") || isdigit(" c "))" \fR.
78 .TP
79 .B "isalpha()"
80 prüft auf Buchstaben, in der standard \fB"C"\fP Spracherweiterung ist es
81 äquivalent zu
82 .BI "(isupper(" c ") || islower(" c "))" \fR.
83 In anderen Spracherweiterungen können weitere Zeichen sein, für die
84 .B isalpha()
85 wahr ist - Zeichen, die weder Groß- noch Kleinbuchstaben sind.
86 .TP
87 .B "isascii()"
88 prüft, ob
89 .I c
90 ein 7-bit
91 .I unsigned char
92 ist, das dem ASCII Zeichensatz entspricht.  Diese Funktion ist eine
93 BSD-und auch SVID-Erweiterung.
94 .TP
95 .B "isblank()"
96 prüft auf Leerzeichen, also ein Space oder ein Tab.  Diese Funktion
97 ist eine GNU-Erweiterung.
98 .TP
99 .B "iscntrl()"
100 prüft auf Kontrollzeichen.
101 .TP
102 .B "isdigit()"
103 prüft auf Ziffern ab.
104 .TP
105 .B "isgraph()"
106 prüft auf druckbare Zeichen außer Leerzeichen ab.
107 .TP
108 .B "islower()"
109 prüft, ob
110 .I c
111 ein Kleinbuchstabe ist.
112 .TP
113 .B "isprint()"
114 prüft auf druckbare Zeichen inklusive Leerzeichen ab.
115 .TP
116 .B "ispunct()"
117 prüft auf druckbare Zeichen, das kein Leerzeichen und kein
118 alphanumerisches Zeichen ist.
119 .TP
120 .B "isspace()"
121 prüft auf Freizeichen.  In den
122 .B """C"""
123 and
124 .B """POSIX"""
125 Spracherweiterung sind dies: Leerzeichen, Seitenvorschub
126 .RB ( '\ef' ),
127 Zeilenumbruch
128 .RB ( '\en' ),
129 Carriage Return
130 .RB ( '\er' ),
131 Horizontaler Tabulator
132 .RB ( '\et' ),
133 und verticaler Tabulator
134 .RB ( '\ev' ).
135 .TP
136 .B "isupper()"
137 prüft auf Großbuchstaben ab.
138 .TP
139 .B "isxdigit()"
140 prüft, ob
141 .I c
142 eine hexadezimales Ziffer ist, also eine von
143 .nl
144 .BR "0 1 2 3 4 5 6 7 8 9 0 a b c d e f A B C D E F" .
145 .SH "RÜCKGABEWERT"
146 Wenn das Zeichen
147 .I c
148 in eine der entsprechenden Kategorien fällt, wird eine Zahl ungleich
149 null zurückgegeben, ansonsten null.
150 .SH "KONFORM ZU"
151 ANSI - C, BSD 4.3.
152 .B isascii()
153 ist sowohl eine BSD- als auch eine SVID-Erweiterung.
154 .B isblank()
155 ist eine GNU-Erweiterung.
156 .SH BUGS
157 Die Details, welche Zeichen zu welcher Klasse gehören, sind von der
158 aktuellen Spracherweiterung abhängig.  Zum Beispiel wird
159 .B isupper()
160 in der standard
161 .B "C"
162 Spracherweiterung kein Ä erkennen.
163 .SH "SIEHE AUCH"
164 .BR tolower (3),
165 .BR toupper (3),
166 .BR setlocale (3),
167 .BR ascii (7),
168 .BR locale (7).