1 cfa37a7b 2004-04-10 devnull .TH CTYPE 3
3 cfa37a7b 2004-04-10 devnull isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, isascii, toascii, _toupper, _tolower, toupper, tolower \- ASCII character classification
4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
5 cfa37a7b 2004-04-10 devnull .B #include <u.h>
7 cfa37a7b 2004-04-10 devnull .B #include <libc.h>
9 cfa37a7b 2004-04-10 devnull .B #include <ctype.h>
11 cfa37a7b 2004-04-10 devnull .if t .2C
12 cfa37a7b 2004-04-10 devnull .B isalpha(c)
14 cfa37a7b 2004-04-10 devnull .B isupper(c)
16 cfa37a7b 2004-04-10 devnull .B islower(c)
18 cfa37a7b 2004-04-10 devnull .B isdigit(c)
20 cfa37a7b 2004-04-10 devnull .B isxdigit(c)
22 cfa37a7b 2004-04-10 devnull .B isalnum(c)
24 cfa37a7b 2004-04-10 devnull .B isspace(c)
26 cfa37a7b 2004-04-10 devnull .B ispunct(c)
28 cfa37a7b 2004-04-10 devnull .B isprint(c)
30 cfa37a7b 2004-04-10 devnull .B isgraph(c)
32 cfa37a7b 2004-04-10 devnull .B iscntrl(c)
34 cfa37a7b 2004-04-10 devnull .B isascii(c)
36 cfa37a7b 2004-04-10 devnull .B _toupper(c)
38 cfa37a7b 2004-04-10 devnull .B _tolower(c)
40 cfa37a7b 2004-04-10 devnull .B toupper(c)
42 cfa37a7b 2004-04-10 devnull .B tolower(c)
44 cfa37a7b 2004-04-10 devnull .B toascii(c)
45 cfa37a7b 2004-04-10 devnull .if t .1C
46 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
47 cfa37a7b 2004-04-10 devnull These macros classify
48 cfa37a7b 2004-04-10 devnull .SM ASCII\c
49 cfa37a7b 2004-04-10 devnull -coded integer values
50 cfa37a7b 2004-04-10 devnull by table lookup.
51 cfa37a7b 2004-04-10 devnull Each is a predicate returning nonzero for true,
52 cfa37a7b 2004-04-10 devnull zero for false.
53 cfa37a7b 2004-04-10 devnull .I Isascii
54 cfa37a7b 2004-04-10 devnull is defined on all integer values; the rest
55 cfa37a7b 2004-04-10 devnull are defined only where
56 cfa37a7b 2004-04-10 devnull .I isascii
57 cfa37a7b 2004-04-10 devnull is true and on the single non-\c
58 cfa37a7b 2004-04-10 devnull .SM ASCII
60 cfa37a7b 2004-04-10 devnull .BR EOF ;
62 bf8a59fa 2004-04-11 devnull .IR fopen (3).
63 cfa37a7b 2004-04-10 devnull .TP "\w'isalnum 'u"
64 cfa37a7b 2004-04-10 devnull .I isalpha
66 cfa37a7b 2004-04-10 devnull is a letter, a\-z or A\-Z
68 cfa37a7b 2004-04-10 devnull .I isupper
70 cfa37a7b 2004-04-10 devnull is an upper case letter, A\-Z
72 cfa37a7b 2004-04-10 devnull .I islower
74 cfa37a7b 2004-04-10 devnull is a lower case letter, a\-z
76 cfa37a7b 2004-04-10 devnull .I isdigit
78 cfa37a7b 2004-04-10 devnull is a digit, 0\-9
80 cfa37a7b 2004-04-10 devnull .I isxdigit
82 cfa37a7b 2004-04-10 devnull is a hexadecimal digit, 0\-9 or a\-f or A\-F
84 cfa37a7b 2004-04-10 devnull .I isalnum
86 cfa37a7b 2004-04-10 devnull is an alphanumeric character, a\-z or A\-Z or 0\-9
88 cfa37a7b 2004-04-10 devnull .I isspace
90 cfa37a7b 2004-04-10 devnull is a space, horizontal tab, newline, vertical tab, formfeed, or carriage return
91 cfa37a7b 2004-04-10 devnull (0x20, 0x9, 0xA, 0xB, 0xC, 0xD)
93 cfa37a7b 2004-04-10 devnull .I ispunct
95 cfa37a7b 2004-04-10 devnull is a punctuation character
98 cfa37a7b 2004-04-10 devnull !"#$%&'()*+,-./:;<=>?@[\e]^_`{|}~\fR)
100 cfa37a7b 2004-04-10 devnull .I isprint
102 cfa37a7b 2004-04-10 devnull is a printing character, 0x20 (space)
103 cfa37a7b 2004-04-10 devnull through 0x7E (tilde)
105 cfa37a7b 2004-04-10 devnull .I isgraph
107 cfa37a7b 2004-04-10 devnull is a visible printing character, 0x21 (exclamation) through 0x7E
110 cfa37a7b 2004-04-10 devnull .I iscntrl
112 cfa37a7b 2004-04-10 devnull is a delete character, 0x7F,
113 cfa37a7b 2004-04-10 devnull or ordinary control character, 0x0 through 0x1F
115 cfa37a7b 2004-04-10 devnull .I isascii
118 cfa37a7b 2004-04-10 devnull .SM ASCII
119 cfa37a7b 2004-04-10 devnull character, 0x0 through 0x7F
121 cfa37a7b 2004-04-10 devnull .I Toascii
122 cfa37a7b 2004-04-10 devnull is not a classification macro;
123 cfa37a7b 2004-04-10 devnull it converts its argument to
124 cfa37a7b 2004-04-10 devnull .SM ASCII
125 cfa37a7b 2004-04-10 devnull range by
126 cfa37a7b 2004-04-10 devnull .IR and ing
127 cfa37a7b 2004-04-10 devnull with 0x7F.
131 cfa37a7b 2004-04-10 devnull is an upper case letter,
132 cfa37a7b 2004-04-10 devnull .I tolower
133 cfa37a7b 2004-04-10 devnull returns the lower case version of the character;
134 cfa37a7b 2004-04-10 devnull otherwise it returns the original character.
135 cfa37a7b 2004-04-10 devnull .I Toupper
136 cfa37a7b 2004-04-10 devnull is similar, returning the upper case version of a character
137 cfa37a7b 2004-04-10 devnull or the original character.
138 cfa37a7b 2004-04-10 devnull .I Tolower
140 cfa37a7b 2004-04-10 devnull .I toupper
141 cfa37a7b 2004-04-10 devnull are functions;
142 cfa37a7b 2004-04-10 devnull .I _tolower
144 cfa37a7b 2004-04-10 devnull .I _toupper
145 cfa37a7b 2004-04-10 devnull are corresponding macros which should only be used when it
146 cfa37a7b 2004-04-10 devnull is known that the argument is upper case or lower case, respectively.
147 cfa37a7b 2004-04-10 devnull .SH SOURCE
148 b5fdffee 2004-04-19 devnull .TF /usr/local/plan9/src/libc/port/ctype.c
150 cfa37a7b 2004-04-10 devnull .B /sys/include/ctype.h
151 cfa37a7b 2004-04-10 devnull for the macros.
153 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/libc/port/ctype.c
154 cfa37a7b 2004-04-10 devnull for the tables.
155 cfa37a7b 2004-04-10 devnull .SH "SEE ALSO
156 bf8a59fa 2004-04-11 devnull .IR isalpharune (3)
157 cfa37a7b 2004-04-10 devnull .SH BUGS
158 cfa37a7b 2004-04-10 devnull These macros are
159 cfa37a7b 2004-04-10 devnull .SM ASCII \c
160 cfa37a7b 2004-04-10 devnull -centric.