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