Print this page
Garrett's man page edits.
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man3c/iswalpha.3c
+++ new/usr/src/man/man3c/iswalpha.3c
1 1 '\" te
2 +.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
2 3 .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. Portions Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
3 4 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
4 5 .\" http://www.opengroup.org/bookstore/.
5 6 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
6 7 .\" This notice shall appear on any product containing this material.
7 8 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
8 9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
9 10 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
10 -.TH ISWALPHA 3C "Apr 19, 2004"
11 +.TH ISWALPHA 3C "Jun 23, 2014"
11 12 .SH NAME
12 13 iswalpha, isenglish, isideogram, iswideogram, isnumber, iswnumber,
13 14 isphonogram, iswphonogram, isspecial, iswspecial, iswalnum, iswascii,
14 15 iswblank, iswcntrl, iswdigit, iswgraph, iswlower, iswprint, iswpunct,
15 16 iswspace, iswupper, iswxdigit, iswhexnumber, iswalpha_l, iswideogram_l,
16 17 iswnumber_l, iswphonogram_l, iswspecial_l, iswalnum_l, iswascii_l,
17 18 iswblank_l, iswcntrl_l, iswdigit_l, iswgraph_l, iswlower_l, iswprint_l,
18 19 iswpunct_l, iswspace_l, iswupper_l, iswhexnumber_l \- wide-character
19 20 code classification functions
20 21
21 22 .SH SYNOPSIS
22 23 .LP
23 24 .nf
24 25 #include <wchar.h>
25 26 #include <wctype.h>
26 27
27 28 \fBint\fR \fBiswalpha\fR(\fBwint_t\fR \fIwc\fR);
28 29 .fi
29 -
30 30 .LP
31 31 .nf
32 32 \fBint\fR \fBisenglish\fR(\fBwint_t\fR \fIwc\fR);
33 33 .fi
34 -
35 34 .LP
36 35 .nf
37 36 \fBint\fR \fBisideogram\fR(\fBwint_t\fR \fIwc\fR);
38 37 .fi
39 -
40 38 .LP
41 39 .nf
42 40 \fBint\fR \fBisnumber\fR(\fBwint_t\fR \fIwc\fR);
43 41 .fi
44 -
45 42 .LP
46 43 .nf
47 44 \fBint\fR \fBisphonogram\fR(\fBwint_t\fR \fIwc\fR);
48 45 .fi
49 -
50 46 .LP
51 47 .nf
52 48 \fBint\fR \fBisspecial\fR(\fBwint_t\fR \fIwc\fR);
53 49 .fi
54 -
55 50 .LP
56 51 .nf
57 52 \fBint\fR \fBiswalnum\fR(\fBwint_t\fR \fIwc\fR);
58 53 .fi
59 -
60 54 .LP
61 55 .nf
62 56 \fBint\fR \fBiswascii\fR(\fBwint_t\fR \fIwc\fR);
63 57 .fi
64 -
65 58 .LP
66 59 .nf
67 60 \fBint\fR \fBiswblank\fR(\fBwint_t\fR \fIwc\fR);
68 61 .fi
69 -
70 62 .LP
71 63 .nf
72 64 \fBint\fR \fBiswcntrl\fR(\fBwint_t\fR \fIwc\fR);
73 65 .fi
74 -
75 66 .LP
76 67 .nf
77 68 \fBint\fR \fBiswdigit\fR(\fBwint_t\fR \fIwc\fR);
78 69 .fi
79 -
80 70 .LP
81 71 .nf
82 72 \fBint\fR \fBiswgraph\fR(\fBwint_t\fR \fIwc\fR);
83 73 .fi
84 -
85 74 .LP
86 75 .nf
87 76 \fBint\fR \fBiswlower\fR(\fBwint_t\fR \fIwc\fR);
88 77 .fi
89 -
90 78 .LP
91 79 .nf
92 80 \fBint\fR \fBiswprint\fR(\fBwint_t\fR \fIwc\fR);
93 81 .fi
94 -
95 82 .LP
96 83 .nf
97 84 \fBint\fR \fBiswpunct\fR(\fBwint_t\fR \fIwc\fR);
98 85 .fi
99 -
100 86 .LP
101 87 .nf
102 88 \fBint\fR \fBiswspace\fR(\fBwint_t\fR \fIwc\fR);
103 89 .fi
104 -
105 90 .LP
106 91 .nf
107 92 \fBint\fR \fBiswupper\fR(\fBwint_t\fR \fIwc\fR);
108 93 .fi
109 -
110 94 .LP
111 95 .nf
112 96 \fBint\fR \fBiswxdigit\fR(\fBwint_t\fR \fIwc\fR);
113 97 .fi
114 -
115 98 .LP
116 99 .nf
100 +\fBint\fR \fBiswhexnumber\fR(\fBwint_t\fR \fIwc\fR);
101 +.fi
102 +.LP
103 +.nf
117 104 \fBint\fR \fBiswideogram\fR(\fBwint_t\fR \fIwc\fR);
118 105 .fi
119 -
120 106 .LP
121 107 .nf
122 108 \fBint\fR \fBiswnumber\fR(\fBwint_t\fR \fIwc\fR);
123 109 .fi
124 -
125 110 .LP
126 111 .nf
127 112 \fBint\fR \fBiswphonogram\fR(\fBwint_t\fR \fIwc\fR);
128 113 .fi
129 -
130 114 .LP
131 115 .nf
132 116 \fBint\fR \fBiswspecial\fR(\fBwint_t\fR \fIwc\fR);
133 117 .fi
134 -
135 -XXX
136 -
137 118 .LP
138 119 .nf
139 -\fBint\fR \fBiswalpha\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
120 +\fBint\fR \fBiswalpha_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
140 121 .fi
141 -
142 122 .LP
143 123 .nf
144 -\fBint\fR \fBiswideogram\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
124 +\fBint\fR \fBiswideogram_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
145 125 .fi
146 -
147 126 .LP
148 127 .nf
149 -\fBint\fR \fBiswnumber\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
128 +\fBint\fR \fBiswnumber_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
150 129 .fi
151 -
152 130 .LP
153 131 .nf
154 -\fBint\fR \fBiswphonogram\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
132 +\fBint\fR \fBiswphonogram_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
155 133 .fi
156 -
157 134 .LP
158 135 .nf
159 -\fBint\fR \fBiswspecial\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
136 +\fBint\fR \fBiswspecial_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
160 137 .fi
161 -
162 138 .LP
163 139 .nf
164 -\fBint\fR \fBiswalnum\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
140 +\fBint\fR \fBiswalnum_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
165 141 .fi
166 -
167 142 .LP
168 143 .nf
169 -\fBint\fR \fBiswascii\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
144 +\fBint\fR \fBiswascii_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
170 145 .fi
171 -
172 146 .LP
173 147 .nf
174 -\fBint\fR \fBiswblank\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
148 +\fBint\fR \fBiswblank_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
175 149 .fi
176 -
177 150 .LP
178 151 .nf
179 -\fBint\fR \fBiswcntrl\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
152 +\fBint\fR \fBiswcntrl_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
180 153 .fi
181 -
182 154 .LP
183 155 .nf
184 -\fBint\fR \fBiswdigit\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
156 +\fBint\fR \fBiswdigit_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
185 157 .fi
186 -
187 158 .LP
188 159 .nf
189 -\fBint\fR \fBiswgraph\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
160 +\fBint\fR \fBiswgraph_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
190 161 .fi
191 -
192 162 .LP
193 163 .nf
194 -\fBint\fR \fBiswlower\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
164 +\fBint\fR \fBiswlower_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
195 165 .fi
196 -
197 166 .LP
198 167 .nf
199 -\fBint\fR \fBiswprint\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
168 +\fBint\fR \fBiswprint_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
200 169 .fi
201 -
202 170 .LP
203 171 .nf
204 -\fBint\fR \fBiswpunct\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
172 +\fBint\fR \fBiswpunct_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
205 173 .fi
206 -
207 174 .LP
208 175 .nf
209 -\fBint\fR \fBiswspace\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
176 +\fBint\fR \fBiswspace_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
210 177 .fi
211 -
212 178 .LP
213 179 .nf
214 180 \fBint\fR \fBiswupper\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
215 181 .fi
216 -
217 182 .LP
218 183 .nf
219 184 \fBint\fR \fBiswxdigit\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
220 185 .fi
221 -
222 -#include <xlocale.h>
223 -
224 186 .LP
225 187 .nf
226 -\fBint\fR \fBiswhexnumber\fR(\fBwint_t\fR \fIwc\fR);
227 -.fi
188 +#include <xlocale.h>
228 189
229 -.LP
230 -.nf
231 190 \fBint\fR \fBiswhexnumber\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
232 191 .fi
233 192
234 193 .SH DESCRIPTION
235 -.sp
236 194 .LP
237 195 These functions test whether \fIwc\fR is a wide-character code representing a
238 196 character of a particular class defined in the \fBLC_CTYPE\fR category of the
239 -current locale as determined by \fBsetlocale\fR(3C) and
240 -\fBuselocale\fR(3C).
241 -.sp
197 +current locale or the locale specified by \fIloc\fR.
242 198 .LP
243 199 The functions \fBiswalpha_l()\fR, \fBiswideogram_l()\fR, \fBiswnumber_l()\fR,
244 200 \fBiswphonogram_l()\fR, \fBiswspecial_l()\fR, \fBiswalnum_l()\fR,
245 201 \fBiswascii_l()\fR, \fBiswblank_l()\fR, \fBiswcntrl_l()\fR, \fBiswdigit_l()\fR,
246 202 \fBiswgraph_l()\fR, \fBiswlower_l()\fR, \fBiswprint_l()\fR, \fBiswpunct_l()\fR,
247 203 \fBiswspace_l()\fR, \fBiswupper_l()\fR, all behave identically to their
248 204 counterparts without the '\fB_l\fR' suffix, but instead of operating on the
249 205 current locale, they operate on the locale specified by \fIloc\fR.
250 -.sp
251 206 .LP
252 207 The functions, \fBiswideogram()\fR, \fBiswnumber()\fR, \fBiswphonogram()\fR,
253 208 \fBiswspecial()\fR, and \fBiswhexnumber()\fR, are respectively identical to
254 209 \fBisideogram()\fR, \fBisnumber()\fR, \fBisphonogram()\fR, \fBisspecial()\fR,
255 210 \fBiswxdigit()\fR respectively. They are provided for compatability purposes.
256 -.sp
257 211 .LP
258 212 In all cases, \fIwc\fR is a \fBwint_t\fR, the value of which must be a
259 213 wide-character code corresponding to a valid character in the current locale or
260 214 must equal the value of the macro \fBWEOF\fR. If the argument has any other
261 215 values, the behavior is undefined.
262 216 .sp
263 217 .ne 2
264 218 .na
265 219 \fB\fBiswalpha(\fR\fIwc\fR\fB)\fR\fR
266 220 .ad
267 221 .RS 19n
268 222 Tests whether \fIwc\fR is a wide-character code representing a character of
269 223 class "alpha" in the program's current locale.
270 224 .RE
271 225
272 226 .sp
273 227 .ne 2
274 228 .na
275 229 \fB\fBisenglish(\fR\fIwc\fR\fB)\fR\fR
276 230 .ad
277 231 .RS 19n
278 232 Tests whether \fIwc\fR is a wide-character code representing an English
279 233 language character, excluding \fBASCII\fR characters.
280 234 .RE
281 235
282 236 .sp
283 237 .ne 2
284 238 .na
285 239 \fB\fBisideogram(\fR\fIwc\fR\fB)\fR\fR
286 240 .ad
287 241 .RS 19n
288 242 Tests whether \fIwc\fR is a wide-character code representing an ideographic
289 243 language character, excluding \fBASCII\fR characters.
290 244 .RE
291 245
292 246 .sp
293 247 .ne 2
294 248 .na
295 249 \fB\fBisnumber(\fR\fIwc\fR\fB)\fR\fR
296 250 .ad
297 251 .RS 19n
298 252 Tests whether \fIwc\fR is a wide-character code representing digit [0\(mi9],
299 253 excluding \fBASCII\fR characters.
300 254 .RE
301 255
302 256 .sp
303 257 .ne 2
304 258 .na
305 259 \fB\fBisphonogram(\fR\fIwc\fR\fB)\fR\fR
306 260 .ad
307 261 .RS 19n
308 262 Tests whether \fIwc\fR is a wide-character code representing a phonetic
309 263 language character, excluding \fBASCII\fR characters.
310 264 .RE
311 265
312 266 .sp
313 267 .ne 2
314 268 .na
315 269 \fB\fBisspecial(\fR\fIwc\fR\fB)\fR\fR
316 270 .ad
317 271 .RS 19n
318 272 Tests whether \fIwc\fR is a wide-character code representing a special language
319 273 character, excluding \fBASCII\fR characters.
320 274 .RE
321 275
322 276 .sp
323 277 .ne 2
324 278 .na
325 279 \fB\fBiswalnum(\fR\fIwc\fR\fB)\fR\fR
326 280 .ad
327 281 .RS 19n
328 282 Tests whether \fIwc\fR is a wide-character code representing a character of
329 283 class "alpha" or "digit" in the program's current locale.
330 284 .RE
331 285
332 286 .sp
333 287 .ne 2
334 288 .na
335 289 \fB\fBiswascii(\fR\fIwc\fR\fB)\fR\fR
336 290 .ad
337 291 .RS 19n
338 292 Tests whether \fIwc\fR is a wide-character code representing an \fBASCII\fR
339 293 character.
340 294 .RE
341 295
342 296 .sp
343 297 .ne 2
344 298 .na
345 299 \fB\fBiswblank(\fR\fIwc\fR\fB)\fR\fR
346 300 .ad
347 301 .RS 19n
348 302 Tests whether \fIwc\fR is a wide-character code representing a character of
349 303 class "blank" in the program's current locale. This function is not available
350 304 to applications conforming to standards prior to SUSv3. See \fBstandards\fR(5).
351 305 .RE
352 306
353 307 .sp
354 308 .ne 2
355 309 .na
356 310 \fB\fBiswlower(\fR\fIwc\fR\fB)\fR\fR
357 311 .ad
358 312 .RS 19n
359 313 Tests whether \fIwc\fR is a wide-character code representing a character of
360 314 class "lower" in the program's current locale.
361 315 .RE
362 316
363 317 .sp
364 318 .ne 2
365 319 .na
366 320 \fB\fBiswcntrl(\fR\fIwc\fR\fB)\fR\fR
367 321 .ad
368 322 .RS 19n
369 323 Tests whether \fIwc\fR is a wide-character code representing a character of
370 324 class "cntrl" in the program's current locale.
371 325 .RE
372 326
373 327 .sp
374 328 .ne 2
375 329 .na
376 330 \fB\fBiswdigit(\fR\fIwc\fR\fB)\fR\fR
377 331 .ad
378 332 .RS 19n
379 333 Tests whether \fIwc\fR is a wide-character code representing a character of
380 334 class "digit" in the program's current locale.
381 335 .RE
382 336
383 337 .sp
384 338 .ne 2
385 339 .na
386 340 \fB\fBiswgraph(\fR\fIwc\fR\fB)\fR\fR
387 341 .ad
388 342 .RS 19n
389 343 Tests whether \fIwc\fR is a wide-character code representing a character of
390 344 class "graph" in the program's current locale.
391 345 .RE
392 346
393 347 .sp
394 348 .ne 2
395 349 .na
396 350 \fB\fBiswprint(\fR\fIwc\fR\fB)\fR\fR
397 351 .ad
398 352 .RS 19n
399 353 Tests whether \fIwc\fR is a wide-character code representing a character of
400 354 class "print" in the program's current locale.
401 355 .RE
402 356
403 357 .sp
404 358 .ne 2
405 359 .na
406 360 \fB\fBiswpunct(\fR\fIwc\fR\fB)\fR\fR
407 361 .ad
408 362 .RS 19n
409 363 Tests whether \fIwc\fR is a wide-character code representing a character of
410 364 class "punct" in the program's current locale.
411 365 .RE
412 366
413 367 .sp
414 368 .ne 2
415 369 .na
416 370 \fB\fBiswspace(\fR\fIwc\fR\fB)\fR\fR
417 371 .ad
418 372 .RS 19n
419 373 Tests whether \fIwc\fR is a wide-character code representing a character of
420 374 class "space" in the program's current locale.
421 375 .RE
422 376
423 377 .sp
424 378 .ne 2
425 379 .na
426 380 \fB\fBiswupper(\fR\fIwc\fR\fB)\fR\fR
427 381 .ad
428 382 .RS 19n
429 383 Tests whether \fIwc\fR is a wide-character code representing a character of
430 384 class "upper" in the program's current locale.
431 385 .RE
432 386
433 387 .sp
434 388 .ne 2
435 389 .na
436 390 \fB\fBiswxdigit(\fR\fIwc\fR\fB)\fR\fR
|
↓ open down ↓ |
170 lines elided |
↑ open up ↑ |
437 391 .ad
438 392 .RS 19n
439 393 Tests whether \fIwc\fR is a wide-character code representing a character of
440 394 class "xdigit" in the program's current locale.
441 395 .RE
442 396
443 397 .SH ATTRIBUTES
444 398 .sp
445 399 .LP
446 400 See \fBattributes\fR(5) for descriptions of the following attributes:
447 -.sp
448 -
449 -.sp
450 401 .TS
451 402 box;
452 -l | l
403 +c | c
453 404 l | l .
454 405 ATTRIBUTE TYPE ATTRIBUTE VALUE
455 406 _
456 407 CSI Enabled
457 408 _
458 -Interface Stability See below.
409 +Interface Stability See below.
459 410 _
460 -MT-Level MT-Safe with exceptions
411 +MT-Level MT-Safe
461 412 .TE
462 413
463 -.sp
464 414 .LP
465 415 The \fBiswalpha()\fR, \fBiswalnum()\fR, \fBiswblank()\fR, \fBiswcntrl()\fR,
466 416 \fBiswdigit()\fR, \fBiswgraph()\fR, \fBiswlower()\fR, \fBiswprint()\fR,
467 417 \fBiswpunct()\fR, \fBiswspace()\fR, \fBiswupper()\fR, and \fBiswxdigit()\fR
468 418 functions are Standard.
469 -.sp
470 419 .LP
471 420 The \fBiswalpha_l()\fR, \fBiswalnum_l()\fR, \fBiswblank_l()\fR, \fBiswcntrl_l()\fR,
472 421 \fBiswdigit_l()\fR, \fBiswgraph_l()\fR, \fBiswlower_l()\fR, \fBiswprint_l()\fR,
473 422 \fBiswpunct_l()\fR, \fBiswspace_l()\fR, and \fBiswupper_l()\fR
474 423 functions are Standard.
475 424 .SH SEE ALSO
476 -.sp
477 425 .LP
478 -\fBlocaledef\fR(1), \fBsetlocale\fR(3C), \fBstdio\fR(3C), \fBuselocale\fR(3C),
426 +\fBlocaledef\fR(1), \fBnewlocale\fR(3C),
427 +\fBsetlocale\fR(3C), \fBstdio\fR(3C), \fBuselocale\fR(3C),
479 428 \fBascii\fR(5), \fBattributes\fR(5), \fBstandards\fR(5)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX