| blob | be783e5151decf9953a5afd13a028eb64b256661 |
1 '\" te
2 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
3 .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. Portions Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
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
5 .\" http://www.opengroup.org/bookstore/.
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.
7 .\" This notice shall appear on any product containing this material.
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.
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.
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]
11 .TH ISWALPHA 3C "April 9, 2016"
12 .SH NAME
13 iswalpha, isenglish, isideogram, iswideogram, isnumber, iswnumber,
14 isphonogram, iswphonogram, isspecial, iswspecial, iswalnum, iswascii,
15 iswblank, iswcntrl, iswdigit, iswgraph, iswlower, iswprint, iswpunct,
16 iswspace, iswupper, iswxdigit, iswhexnumber, iswalpha_l, iswideogram_l,
17 iswnumber_l, iswphonogram_l, iswspecial_l, iswalnum_l, iswascii_l,
18 iswblank_l, iswcntrl_l, iswdigit_l, iswgraph_l, iswlower_l, iswprint_l,
19 iswpunct_l, iswspace_l, iswupper_l, iswxdigit_l, iswhexnumber_l \-
20 wide-character code classification functions
22 .SH SYNOPSIS
23 .LP
24 .nf
25 #include <wchar.h>
26 #include <wctype.h>
28 \fBint\fR \fBiswalpha\fR(\fBwint_t\fR \fIwc\fR);
29 .fi
30 .LP
31 .nf
32 \fBint\fR \fBisenglish\fR(\fBwint_t\fR \fIwc\fR);
33 .fi
34 .LP
35 .nf
36 \fBint\fR \fBisideogram\fR(\fBwint_t\fR \fIwc\fR);
37 .fi
38 .LP
39 .nf
40 \fBint\fR \fBisnumber\fR(\fBwint_t\fR \fIwc\fR);
41 .fi
42 .LP
43 .nf
44 \fBint\fR \fBisphonogram\fR(\fBwint_t\fR \fIwc\fR);
45 .fi
46 .LP
47 .nf
48 \fBint\fR \fBisspecial\fR(\fBwint_t\fR \fIwc\fR);
49 .fi
50 .LP
51 .nf
52 \fBint\fR \fBiswalnum\fR(\fBwint_t\fR \fIwc\fR);
53 .fi
54 .LP
55 .nf
56 \fBint\fR \fBiswascii\fR(\fBwint_t\fR \fIwc\fR);
57 .fi
58 .LP
59 .nf
60 \fBint\fR \fBiswblank\fR(\fBwint_t\fR \fIwc\fR);
61 .fi
62 .LP
63 .nf
64 \fBint\fR \fBiswcntrl\fR(\fBwint_t\fR \fIwc\fR);
65 .fi
66 .LP
67 .nf
68 \fBint\fR \fBiswdigit\fR(\fBwint_t\fR \fIwc\fR);
69 .fi
70 .LP
71 .nf
72 \fBint\fR \fBiswgraph\fR(\fBwint_t\fR \fIwc\fR);
73 .fi
74 .LP
75 .nf
76 \fBint\fR \fBiswlower\fR(\fBwint_t\fR \fIwc\fR);
77 .fi
78 .LP
79 .nf
80 \fBint\fR \fBiswprint\fR(\fBwint_t\fR \fIwc\fR);
81 .fi
82 .LP
83 .nf
84 \fBint\fR \fBiswpunct\fR(\fBwint_t\fR \fIwc\fR);
85 .fi
86 .LP
87 .nf
88 \fBint\fR \fBiswspace\fR(\fBwint_t\fR \fIwc\fR);
89 .fi
90 .LP
91 .nf
92 \fBint\fR \fBiswupper\fR(\fBwint_t\fR \fIwc\fR);
93 .fi
94 .LP
95 .nf
96 \fBint\fR \fBiswxdigit\fR(\fBwint_t\fR \fIwc\fR);
97 .fi
98 .LP
99 .nf
100 \fBint\fR \fBiswhexnumber\fR(\fBwint_t\fR \fIwc\fR);
101 .fi
102 .LP
103 .nf
104 \fBint\fR \fBiswideogram\fR(\fBwint_t\fR \fIwc\fR);
105 .fi
106 .LP
107 .nf
108 \fBint\fR \fBiswnumber\fR(\fBwint_t\fR \fIwc\fR);
109 .fi
110 .LP
111 .nf
112 \fBint\fR \fBiswphonogram\fR(\fBwint_t\fR \fIwc\fR);
113 .fi
114 .LP
115 .nf
116 \fBint\fR \fBiswspecial\fR(\fBwint_t\fR \fIwc\fR);
117 .fi
118 .LP
119 .nf
120 \fBint\fR \fBiswalpha_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
121 .fi
122 .LP
123 .nf
124 \fBint\fR \fBiswideogram_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
125 .fi
126 .LP
127 .nf
128 \fBint\fR \fBiswnumber_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
129 .fi
130 .LP
131 .nf
132 \fBint\fR \fBiswphonogram_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
133 .fi
134 .LP
135 .nf
136 \fBint\fR \fBiswspecial_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
137 .fi
138 .LP
139 .nf
140 \fBint\fR \fBiswalnum_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
141 .fi
142 .LP
143 .nf
144 \fBint\fR \fBiswascii_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
145 .fi
146 .LP
147 .nf
148 \fBint\fR \fBiswblank_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
149 .fi
150 .LP
151 .nf
152 \fBint\fR \fBiswcntrl_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
153 .fi
154 .LP
155 .nf
156 \fBint\fR \fBiswdigit_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
157 .fi
158 .LP
159 .nf
160 \fBint\fR \fBiswgraph_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
161 .fi
162 .LP
163 .nf
164 \fBint\fR \fBiswlower_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
165 .fi
166 .LP
167 .nf
168 \fBint\fR \fBiswprint_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
169 .fi
170 .LP
171 .nf
172 \fBint\fR \fBiswpunct_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
173 .fi
174 .LP
175 .nf
176 \fBint\fR \fBiswspace_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
177 .fi
178 .LP
179 .nf
180 \fBint\fR \fBiswupper\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
181 .fi
182 .LP
183 .nf
184 \fBint\fR \fBiswxdigit\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
185 .fi
186 .LP
187 .nf
188 \fBint\fR \fBiswxdigit_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
189 .fi
190 .LP
191 .nf
192 \fBint\fR \fBiswhexnumber_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
193 .fi
195 .SH DESCRIPTION
196 .LP
197 These functions test whether \fIwc\fR is a wide-character code representing a
198 character of a particular class defined in the \fBLC_CTYPE\fR category of the
199 current locale or the locale specified by \fIloc\fR.
200 .LP
201 The functions \fBiswalpha_l()\fR, \fBiswideogram_l()\fR, \fBiswnumber_l()\fR,
202 \fBiswphonogram_l()\fR, \fBiswspecial_l()\fR, \fBiswalnum_l()\fR,
203 \fBiswascii_l()\fR, \fBiswblank_l()\fR, \fBiswcntrl_l()\fR, \fBiswdigit_l()\fR,
204 \fBiswgraph_l()\fR, \fBiswlower_l()\fR, \fBiswprint_l()\fR, \fBiswpunct_l()\fR,
205 \fBiswspace_l()\fR, \fBiswupper_l()\fR, all behave identically to their
206 counterparts without the '\fB_l\fR' suffix, but instead of operating on the
207 current locale, they operate on the locale specified by \fIloc\fR.
208 .LP
209 The functions, \fBiswideogram()\fR, \fBiswnumber()\fR, \fBiswphonogram()\fR,
210 \fBiswspecial()\fR, and \fBiswhexnumber()\fR, are respectively identical to
211 \fBisideogram()\fR, \fBisnumber()\fR, \fBisphonogram()\fR, \fBisspecial()\fR,
212 \fBiswxdigit()\fR respectively. They are provided for compatibility purposes.
213 .LP
214 In all cases, \fIwc\fR is a \fBwint_t\fR, the value of which must be a
215 wide-character code corresponding to a valid character in the current locale or
216 must equal the value of the macro \fBWEOF\fR. If the argument has any other
217 values, the behavior is undefined.
218 .sp
219 .ne 2
220 .na
221 \fB\fBiswalpha(\fR\fIwc\fR\fB)\fR\fR
222 .ad
223 .RS 19n
224 Tests whether \fIwc\fR is a wide-character code representing a character of
225 class "alpha" in the program's current locale.
226 .RE
228 .sp
229 .ne 2
230 .na
231 \fB\fBisenglish(\fR\fIwc\fR\fB)\fR\fR
232 .ad
233 .RS 19n
234 Tests whether \fIwc\fR is a wide-character code representing an English
235 language character, excluding \fBASCII\fR characters.
236 .RE
238 .sp
239 .ne 2
240 .na
241 \fB\fBisideogram(\fR\fIwc\fR\fB)\fR\fR
242 .ad
243 .RS 19n
244 Tests whether \fIwc\fR is a wide-character code representing an ideographic
245 language character, excluding \fBASCII\fR characters.
246 .RE
248 .sp
249 .ne 2
250 .na
251 \fB\fBisnumber(\fR\fIwc\fR\fB)\fR\fR
252 .ad
253 .RS 19n
254 Tests whether \fIwc\fR is a wide-character code representing digit [0\(mi9],
255 excluding \fBASCII\fR characters.
256 .RE
258 .sp
259 .ne 2
260 .na
261 \fB\fBisphonogram(\fR\fIwc\fR\fB)\fR\fR
262 .ad
263 .RS 19n
264 Tests whether \fIwc\fR is a wide-character code representing a phonetic
265 language character, excluding \fBASCII\fR characters.
266 .RE
268 .sp
269 .ne 2
270 .na
271 \fB\fBisspecial(\fR\fIwc\fR\fB)\fR\fR
272 .ad
273 .RS 19n
274 Tests whether \fIwc\fR is a wide-character code representing a special language
275 character, excluding \fBASCII\fR characters.
276 .RE
278 .sp
279 .ne 2
280 .na
281 \fB\fBiswalnum(\fR\fIwc\fR\fB)\fR\fR
282 .ad
283 .RS 19n
284 Tests whether \fIwc\fR is a wide-character code representing a character of
285 class "alpha" or "digit" in the program's current locale.
286 .RE
288 .sp
289 .ne 2
290 .na
291 \fB\fBiswascii(\fR\fIwc\fR\fB)\fR\fR
292 .ad
293 .RS 19n
294 Tests whether \fIwc\fR is a wide-character code representing an \fBASCII\fR
295 character.
296 .RE
298 .sp
299 .ne 2
300 .na
301 \fB\fBiswblank(\fR\fIwc\fR\fB)\fR\fR
302 .ad
303 .RS 19n
304 Tests whether \fIwc\fR is a wide-character code representing a character of
305 class "blank" in the program's current locale. This function is not available
306 to applications conforming to standards prior to SUSv3. See \fBstandards\fR(5).
307 .RE
309 .sp
310 .ne 2
311 .na
312 \fB\fBiswlower(\fR\fIwc\fR\fB)\fR\fR
313 .ad
314 .RS 19n
315 Tests whether \fIwc\fR is a wide-character code representing a character of
316 class "lower" in the program's current locale.
317 .RE
319 .sp
320 .ne 2
321 .na
322 \fB\fBiswcntrl(\fR\fIwc\fR\fB)\fR\fR
323 .ad
324 .RS 19n
325 Tests whether \fIwc\fR is a wide-character code representing a character of
326 class "cntrl" in the program's current locale.
327 .RE
329 .sp
330 .ne 2
331 .na
332 \fB\fBiswdigit(\fR\fIwc\fR\fB)\fR\fR
333 .ad
334 .RS 19n
335 Tests whether \fIwc\fR is a wide-character code representing a character of
336 class "digit" in the program's current locale.
337 .RE
339 .sp
340 .ne 2
341 .na
342 \fB\fBiswgraph(\fR\fIwc\fR\fB)\fR\fR
343 .ad
344 .RS 19n
345 Tests whether \fIwc\fR is a wide-character code representing a character of
346 class "graph" in the program's current locale.
347 .RE
349 .sp
350 .ne 2
351 .na
352 \fB\fBiswprint(\fR\fIwc\fR\fB)\fR\fR
353 .ad
354 .RS 19n
355 Tests whether \fIwc\fR is a wide-character code representing a character of
356 class "print" in the program's current locale.
357 .RE
359 .sp
360 .ne 2
361 .na
362 \fB\fBiswpunct(\fR\fIwc\fR\fB)\fR\fR
363 .ad
364 .RS 19n
365 Tests whether \fIwc\fR is a wide-character code representing a character of
366 class "punct" in the program's current locale.
367 .RE
369 .sp
370 .ne 2
371 .na
372 \fB\fBiswspace(\fR\fIwc\fR\fB)\fR\fR
373 .ad
374 .RS 19n
375 Tests whether \fIwc\fR is a wide-character code representing a character of
376 class "space" in the program's current locale.
377 .RE
379 .sp
380 .ne 2
381 .na
382 \fB\fBiswupper(\fR\fIwc\fR\fB)\fR\fR
383 .ad
384 .RS 19n
385 Tests whether \fIwc\fR is a wide-character code representing a character of
386 class "upper" in the program's current locale.
387 .RE
389 .sp
390 .ne 2
391 .na
392 \fB\fBiswxdigit(\fR\fIwc\fR\fB)\fR\fR
393 .ad
394 .RS 19n
395 Tests whether \fIwc\fR is a wide-character code representing a character of
396 class "xdigit" in the program's current locale.
397 .RE
399 .SH ATTRIBUTES
400 .LP
401 See \fBattributes\fR(5) for descriptions of the following attributes:
402 .TS
403 box;
404 c | c
405 l | l .
406 ATTRIBUTE TYPE ATTRIBUTE VALUE
407 _
408 CSI Enabled
409 _
410 Interface Stability See below.
411 _
412 MT-Level MT-Safe
413 .TE
415 .LP
416 The \fBiswalpha()\fR, \fBiswalnum()\fR, \fBiswblank()\fR, \fBiswcntrl()\fR,
417 \fBiswdigit()\fR, \fBiswgraph()\fR, \fBiswlower()\fR, \fBiswprint()\fR,
418 \fBiswpunct()\fR, \fBiswspace()\fR, \fBiswupper()\fR, and \fBiswxdigit()\fR
419 functions are Standard.
420 .LP
421 The \fBiswalpha_l()\fR, \fBiswalnum_l()\fR, \fBiswblank_l()\fR, \fBiswcntrl_l()\fR,
422 \fBiswdigit_l()\fR, \fBiswgraph_l()\fR, \fBiswlower_l()\fR, \fBiswprint_l()\fR,
423 \fBiswpunct_l()\fR, \fBiswspace_l()\fR, and \fBiswupper_l()\fR
424 functions are Standard.
425 .SH SEE ALSO
426 .LP
427 \fBlocaledef\fR(1), \fBnewlocale\fR(3C),
428 \fBsetlocale\fR(3C), \fBstdio\fR(3C), \fBuselocale\fR(3C),
429 \fBascii\fR(5), \fBattributes\fR(5), \fBstandards\fR(5)