1 cfa37a7b 2004-04-10 devnull .TH CTYPE 3
  2 cfa37a7b 2004-04-10 devnull .SH NAME
  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>
  6 cfa37a7b 2004-04-10 devnull .br
  7 cfa37a7b 2004-04-10 devnull .B #include <libc.h>
  8 cfa37a7b 2004-04-10 devnull .br
  9 cfa37a7b 2004-04-10 devnull .B #include <ctype.h>
 10 cfa37a7b 2004-04-10 devnull .PP
 11 cfa37a7b 2004-04-10 devnull .if t .2C
 12 cfa37a7b 2004-04-10 devnull .B isalpha(c)
 13 cfa37a7b 2004-04-10 devnull .PP
 14 cfa37a7b 2004-04-10 devnull .B isupper(c)
 15 cfa37a7b 2004-04-10 devnull .PP
 16 cfa37a7b 2004-04-10 devnull .B islower(c)
 17 cfa37a7b 2004-04-10 devnull .PP
 18 cfa37a7b 2004-04-10 devnull .B isdigit(c)
 19 cfa37a7b 2004-04-10 devnull .PP
 20 cfa37a7b 2004-04-10 devnull .B isxdigit(c)
 21 cfa37a7b 2004-04-10 devnull .PP
 22 cfa37a7b 2004-04-10 devnull .B isalnum(c)
 23 cfa37a7b 2004-04-10 devnull .PP
 24 cfa37a7b 2004-04-10 devnull .B isspace(c)
 25 cfa37a7b 2004-04-10 devnull .PP
 26 cfa37a7b 2004-04-10 devnull .B ispunct(c)
 27 cfa37a7b 2004-04-10 devnull .PP
 28 cfa37a7b 2004-04-10 devnull .B isprint(c)
 29 cfa37a7b 2004-04-10 devnull .PP
 30 cfa37a7b 2004-04-10 devnull .B isgraph(c)
 31 cfa37a7b 2004-04-10 devnull .PP
 32 cfa37a7b 2004-04-10 devnull .B iscntrl(c)
 33 cfa37a7b 2004-04-10 devnull .PP
 34 cfa37a7b 2004-04-10 devnull .B isascii(c)
 35 cfa37a7b 2004-04-10 devnull .PP
 36 cfa37a7b 2004-04-10 devnull .B _toupper(c)
 37 cfa37a7b 2004-04-10 devnull .PP
 38 cfa37a7b 2004-04-10 devnull .B _tolower(c)
 39 cfa37a7b 2004-04-10 devnull .PP
 40 cfa37a7b 2004-04-10 devnull .B toupper(c)
 41 cfa37a7b 2004-04-10 devnull .PP
 42 cfa37a7b 2004-04-10 devnull .B tolower(c)
 43 cfa37a7b 2004-04-10 devnull .PP
 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
 59 cfa37a7b 2004-04-10 devnull value
 60 cfa37a7b 2004-04-10 devnull .BR EOF ;
 61 cfa37a7b 2004-04-10 devnull see
 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
 65 cfa37a7b 2004-04-10 devnull .I c
 66 cfa37a7b 2004-04-10 devnull is a letter, a\-z or A\-Z
 67 cfa37a7b 2004-04-10 devnull .TP
 68 cfa37a7b 2004-04-10 devnull .I isupper
 69 cfa37a7b 2004-04-10 devnull .I c
 70 cfa37a7b 2004-04-10 devnull is an upper case letter, A\-Z
 71 cfa37a7b 2004-04-10 devnull .TP
 72 cfa37a7b 2004-04-10 devnull .I islower
 73 cfa37a7b 2004-04-10 devnull .I c
 74 cfa37a7b 2004-04-10 devnull is a lower case letter, a\-z
 75 cfa37a7b 2004-04-10 devnull .TP
 76 cfa37a7b 2004-04-10 devnull .I isdigit
 77 cfa37a7b 2004-04-10 devnull .I c
 78 cfa37a7b 2004-04-10 devnull is a digit, 0\-9
 79 cfa37a7b 2004-04-10 devnull .TP
 80 cfa37a7b 2004-04-10 devnull .I isxdigit
 81 cfa37a7b 2004-04-10 devnull .I c
 82 cfa37a7b 2004-04-10 devnull is a hexadecimal digit, 0\-9 or a\-f or A\-F
 83 cfa37a7b 2004-04-10 devnull .TP
 84 cfa37a7b 2004-04-10 devnull .I isalnum
 85 cfa37a7b 2004-04-10 devnull .I c
 86 cfa37a7b 2004-04-10 devnull is an alphanumeric character, a\-z or A\-Z or 0\-9
 87 cfa37a7b 2004-04-10 devnull .TP
 88 cfa37a7b 2004-04-10 devnull .I isspace
 89 cfa37a7b 2004-04-10 devnull .I c
 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)
 92 cfa37a7b 2004-04-10 devnull .TP
 93 cfa37a7b 2004-04-10 devnull .I ispunct
 94 cfa37a7b 2004-04-10 devnull .I c
 95 cfa37a7b 2004-04-10 devnull is a punctuation character
 96 cfa37a7b 2004-04-10 devnull (one of
 97 cfa37a7b 2004-04-10 devnull .L
 98 cfa37a7b 2004-04-10 devnull !"#$%&'()*+,-./:;<=>?@[\e]^_`{|}~\fR)
 99 cfa37a7b 2004-04-10 devnull .TP
100 cfa37a7b 2004-04-10 devnull .I isprint
101 cfa37a7b 2004-04-10 devnull .I c
102 cfa37a7b 2004-04-10 devnull is a printing character, 0x20 (space)
103 cfa37a7b 2004-04-10 devnull through 0x7E (tilde) 
104 cfa37a7b 2004-04-10 devnull .TP
105 cfa37a7b 2004-04-10 devnull .I isgraph
106 cfa37a7b 2004-04-10 devnull .I c
107 cfa37a7b 2004-04-10 devnull is a visible printing character, 0x21 (exclamation) through 0x7E
108 cfa37a7b 2004-04-10 devnull (tilde)
109 cfa37a7b 2004-04-10 devnull .TP
110 cfa37a7b 2004-04-10 devnull .I iscntrl
111 cfa37a7b 2004-04-10 devnull .I c
112 cfa37a7b 2004-04-10 devnull is a delete character, 0x7F,
113 cfa37a7b 2004-04-10 devnull or ordinary control character, 0x0 through 0x1F
114 cfa37a7b 2004-04-10 devnull .TP
115 cfa37a7b 2004-04-10 devnull .I isascii
116 cfa37a7b 2004-04-10 devnull .I c
117 cfa37a7b 2004-04-10 devnull is an
118 cfa37a7b 2004-04-10 devnull .SM ASCII
119 cfa37a7b 2004-04-10 devnull character, 0x0 through 0x7F
120 cfa37a7b 2004-04-10 devnull .PP
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.
128 cfa37a7b 2004-04-10 devnull .PP
129 cfa37a7b 2004-04-10 devnull If
130 cfa37a7b 2004-04-10 devnull .I c
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
139 cfa37a7b 2004-04-10 devnull and
140 cfa37a7b 2004-04-10 devnull .I toupper
141 cfa37a7b 2004-04-10 devnull are functions;
142 cfa37a7b 2004-04-10 devnull .I _tolower
143 cfa37a7b 2004-04-10 devnull and
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
149 cfa37a7b 2004-04-10 devnull .TP
150 cfa37a7b 2004-04-10 devnull .B /sys/include/ctype.h
151 cfa37a7b 2004-04-10 devnull for the macros.
152 cfa37a7b 2004-04-10 devnull .TP
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.