Update.
[platform/upstream/glibc.git] / wctype / wctype.h
1 /* Copyright (C) 1996,97,98,99,2000,01,02 Free Software Foundation, Inc.
2    This file is part of the GNU C Library.
3
4    The GNU C Library is free software; you can redistribute it and/or
5    modify it under the terms of the GNU Lesser General Public
6    License as published by the Free Software Foundation; either
7    version 2.1 of the License, or (at your option) any later version.
8
9    The GNU C Library is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12    Lesser General Public License for more details.
13
14    You should have received a copy of the GNU Lesser General Public
15    License along with the GNU C Library; if not, write to the Free
16    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
17    02111-1307 USA.  */
18
19 /*
20  *      ISO C99 Standard: 7.25
21  *      Wide character classification and mapping utilities  <wctype.h>
22  */
23
24 #ifndef _WCTYPE_H
25
26 #include <features.h>
27 #include <bits/types.h>
28
29 #ifndef __need_iswxxx
30 # define _WCTYPE_H      1
31
32 /* We try to get wint_t from <stddef.h>, but not all GCC versions define it
33    there.  So define it ourselves if it remains undefined.  */
34 # define __need_wint_t
35 # include <stddef.h>
36 # ifndef _WINT_T
37 /* Integral type unchanged by default argument promotions that can
38    hold any value corresponding to members of the extended character
39    set, as well as at least one value that does not correspond to any
40    member of the extended character set.  */
41 #  define _WINT_T
42 typedef unsigned int wint_t;
43 # else
44 #  ifdef __USE_ISOC99
45 __USING_NAMESPACE_C99(wint_t)
46 #  endif
47 __END_NAMESPACE_C99
48 # endif
49
50 /* Constant expression of type `wint_t' whose value does not correspond
51    to any member of the extended character set.  */
52 # ifndef WEOF
53 #  define WEOF (0xffffffffu)
54 # endif
55 #endif
56 #undef __need_iswxxx
57
58
59 /* The following part is also used in the <wcsmbs.h> header when compiled
60    in the Unix98 compatibility mode.  */
61 #ifndef __iswxxx_defined
62 # define __iswxxx_defined       1
63
64 __BEGIN_NAMESPACE_C99
65 /* Scalar type that can hold values which represent locale-specific
66    character classifications.  */
67 typedef unsigned long int wctype_t;
68 __END_NAMESPACE_C99
69
70 # ifndef _ISwbit
71 /* The characteristics are stored always in network byte order (big
72    endian).  We define the bit value interpretations here dependent on the
73    machine's byte order.  */
74
75 #  include <endian.h>
76 #  if __BYTE_ORDER == __BIG_ENDIAN
77 #   define _ISwbit(bit) (1 << (bit))
78 #  else /* __BYTE_ORDER == __LITTLE_ENDIAN */
79 #   define _ISwbit(bit) \
80         ((bit) < 8 ? (int) ((1UL << (bit)) << 24)                             \
81          : ((bit) < 16 ? (int) ((1UL << (bit)) << 8)                          \
82             : ((bit) < 24 ? (int) ((1UL << (bit)) >> 8)                       \
83                : (int) ((1UL << (bit)) >> 24))))
84 #  endif
85
86 enum
87 {
88   __ISwupper = 0,                       /* UPPERCASE.  */
89   __ISwlower = 1,                       /* lowercase.  */
90   __ISwalpha = 2,                       /* Alphabetic.  */
91   __ISwdigit = 3,                       /* Numeric.  */
92   __ISwxdigit = 4,                      /* Hexadecimal numeric.  */
93   __ISwspace = 5,                       /* Whitespace.  */
94   __ISwprint = 6,                       /* Printing.  */
95   __ISwgraph = 7,                       /* Graphical.  */
96   __ISwblank = 8,                       /* Blank (usually SPC and TAB).  */
97   __ISwcntrl = 9,                       /* Control character.  */
98   __ISwpunct = 10,                      /* Punctuation.  */
99   __ISwalnum = 11,                      /* Alphanumeric.  */
100
101   _ISwupper = _ISwbit (__ISwupper),     /* UPPERCASE.  */
102   _ISwlower = _ISwbit (__ISwlower),     /* lowercase.  */
103   _ISwalpha = _ISwbit (__ISwalpha),     /* Alphabetic.  */
104   _ISwdigit = _ISwbit (__ISwdigit),     /* Numeric.  */
105   _ISwxdigit = _ISwbit (__ISwxdigit),   /* Hexadecimal numeric.  */
106   _ISwspace = _ISwbit (__ISwspace),     /* Whitespace.  */
107   _ISwprint = _ISwbit (__ISwprint),     /* Printing.  */
108   _ISwgraph = _ISwbit (__ISwgraph),     /* Graphical.  */
109   _ISwblank = _ISwbit (__ISwblank),     /* Blank (usually SPC and TAB).  */
110   _ISwcntrl = _ISwbit (__ISwcntrl),     /* Control character.  */
111   _ISwpunct = _ISwbit (__ISwpunct),     /* Punctuation.  */
112   _ISwalnum = _ISwbit (__ISwalnum)      /* Alphanumeric.  */
113 };
114 # endif /* Not _ISwbit  */
115
116
117 __BEGIN_DECLS
118
119 __BEGIN_NAMESPACE_C99
120 /*
121  * Wide-character classification functions: 7.15.2.1.
122  */
123
124 /* Test for any wide character for which `iswalpha' or `iswdigit' is
125    true.  */
126 extern int iswalnum (wint_t __wc) __THROW;
127
128 /* Test for any wide character for which `iswupper' or 'iswlower' is
129    true, or any wide character that is one of a locale-specific set of
130    wide-characters for which none of `iswcntrl', `iswdigit',
131    `iswpunct', or `iswspace' is true.  */
132 extern int iswalpha (wint_t __wc) __THROW;
133
134 /* Test for any control wide character.  */
135 extern int iswcntrl (wint_t __wc) __THROW;
136
137 /* Test for any wide character that corresponds to a decimal-digit
138    character.  */
139 extern int iswdigit (wint_t __wc) __THROW;
140
141 /* Test for any wide character for which `iswprint' is true and
142    `iswspace' is false.  */
143 extern int iswgraph (wint_t __wc) __THROW;
144
145 /* Test for any wide character that corresponds to a lowercase letter
146    or is one of a locale-specific set of wide characters for which
147    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
148 extern int iswlower (wint_t __wc) __THROW;
149
150 /* Test for any printing wide character.  */
151 extern int iswprint (wint_t __wc) __THROW;
152
153 /* Test for any printing wide character that is one of a
154    locale-specific et of wide characters for which neither `iswspace'
155    nor `iswalnum' is true.  */
156 extern int iswpunct (wint_t __wc) __THROW;
157
158 /* Test for any wide character that corresponds to a locale-specific
159    set of wide characters for which none of `iswalnum', `iswgraph', or
160    `iswpunct' is true.  */
161 extern int iswspace (wint_t __wc) __THROW;
162
163 /* Test for any wide character that corresponds to an uppercase letter
164    or is one of a locale-specific set of wide character for which none
165    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
166 extern int iswupper (wint_t __wc) __THROW;
167
168 /* Test for any wide character that corresponds to a hexadecimal-digit
169    character equivalent to that performed be the functions described
170    in the previous subclause.  */
171 extern int iswxdigit (wint_t __wc) __THROW;
172
173 /* Test for any wide character that corresponds to a standard blank
174    wide character or a locale-specific set of wide characters for
175    which `iswalnum' is false.  */
176 # ifdef __USE_ISOC99
177 extern int iswblank (wint_t __wc) __THROW;
178 # endif
179
180 /*
181  * Extensible wide-character classification functions: 7.15.2.2.
182  */
183
184 /* Construct value that describes a class of wide characters identified
185    by the string argument PROPERTY.  */
186 extern wctype_t wctype (__const char *__property) __THROW;
187
188 /* Determine whether the wide-character WC has the property described by
189    DESC.  */
190 extern int iswctype (wint_t __wc, wctype_t __desc) __THROW;
191 __END_NAMESPACE_C99
192
193
194 /*
195  * Wide-character case-mapping functions: 7.15.3.1.
196  */
197
198 __BEGIN_NAMESPACE_C99
199 /* Scalar type that can hold values which represent locale-specific
200    character mappings.  */
201 typedef __const __int32_t *wctrans_t;
202 __END_NAMESPACE_C99
203 #ifdef __USE_GNU
204 __USING_NAMESPACE_C99(wctrans_t)
205 #endif
206
207 __BEGIN_NAMESPACE_C99
208 /* Converts an uppercase letter to the corresponding lowercase letter.  */
209 extern wint_t towlower (wint_t __wc) __THROW;
210
211 /* Converts an lowercase letter to the corresponding uppercase letter.  */
212 extern wint_t towupper (wint_t __wc) __THROW;
213 __END_NAMESPACE_C99
214
215 __END_DECLS
216
217 #endif  /* need iswxxx.  */
218
219
220 /* The remaining definitions and declarations must not appear in the
221    <wcsmbs.h> header.  */
222 #ifdef _WCTYPE_H
223
224 /*
225  * Extensible wide-character mapping functions: 7.15.3.2.
226  */
227
228 __BEGIN_DECLS
229
230 __BEGIN_NAMESPACE_C99
231 /* Construct value that describes a mapping between wide characters
232    identified by the string argument PROPERTY.  */
233 extern wctrans_t wctrans (__const char *__property) __THROW;
234
235 /* Map the wide character WC using the mapping described by DESC.  */
236 extern wint_t towctrans (wint_t __wc, wctrans_t __desc) __THROW;
237 __END_NAMESPACE_C99
238
239 # ifdef __USE_GNU
240 /* Declare the interface to extended locale model.  */
241 #  include <xlocale.h>
242
243 /* Test for any wide character for which `iswalpha' or `iswdigit' is
244    true.  */
245 extern int iswalnum_l (wint_t __wc, __locale_t __locale) __THROW;
246
247 /* Test for any wide character for which `iswupper' or 'iswlower' is
248    true, or any wide character that is one of a locale-specific set of
249    wide-characters for which none of `iswcntrl', `iswdigit',
250    `iswpunct', or `iswspace' is true.  */
251 extern int iswalpha_l (wint_t __wc, __locale_t __locale) __THROW;
252
253 /* Test for any control wide character.  */
254 extern int iswcntrl_l (wint_t __wc, __locale_t __locale) __THROW;
255
256 /* Test for any wide character that corresponds to a decimal-digit
257    character.  */
258 extern int iswdigit_l (wint_t __wc, __locale_t __locale) __THROW;
259
260 /* Test for any wide character for which `iswprint' is true and
261    `iswspace' is false.  */
262 extern int iswgraph_l (wint_t __wc, __locale_t __locale) __THROW;
263
264 /* Test for any wide character that corresponds to a lowercase letter
265    or is one of a locale-specific set of wide characters for which
266    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
267 extern int iswlower_l (wint_t __wc, __locale_t __locale) __THROW;
268
269 /* Test for any printing wide character.  */
270 extern int iswprint_l (wint_t __wc, __locale_t __locale) __THROW;
271
272 /* Test for any printing wide character that is one of a
273    locale-specific et of wide characters for which neither `iswspace'
274    nor `iswalnum' is true.  */
275 extern int iswpunct_l (wint_t __wc, __locale_t __locale) __THROW;
276
277 /* Test for any wide character that corresponds to a locale-specific
278    set of wide characters for which none of `iswalnum', `iswgraph', or
279    `iswpunct' is true.  */
280 extern int iswspace_l (wint_t __wc, __locale_t __locale) __THROW;
281
282 /* Test for any wide character that corresponds to an uppercase letter
283    or is one of a locale-specific set of wide character for which none
284    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
285 extern int iswupper_l (wint_t __wc, __locale_t __locale) __THROW;
286
287 /* Test for any wide character that corresponds to a hexadecimal-digit
288    character equivalent to that performed be the functions described
289    in the previous subclause.  */
290 extern int iswxdigit_l (wint_t __wc, __locale_t __locale) __THROW;
291
292 /* Test for any wide character that corresponds to a standard blank
293    wide character or a locale-specific set of wide characters for
294    which `iswalnum' is false.  */
295 extern int iswblank_l (wint_t __wc, __locale_t __locale) __THROW;
296
297 /* Construct value that describes a class of wide characters identified
298    by the string argument PROPERTY.  */
299 extern wctype_t wctype_l (__const char *__property, __locale_t __locale)
300      __THROW;
301
302 /* Determine whether the wide-character WC has the property described by
303    DESC.  */
304 extern int iswctype_l (wint_t __wc, wctype_t __desc, __locale_t __locale)
305      __THROW;
306
307
308 /*
309  * Wide-character case-mapping functions.
310  */
311
312 /* Converts an uppercase letter to the corresponding lowercase letter.  */
313 extern wint_t towlower_l (wint_t __wc, __locale_t __locale) __THROW;
314
315 /* Converts an lowercase letter to the corresponding uppercase letter.  */
316 extern wint_t towupper_l (wint_t __wc, __locale_t __locale) __THROW;
317
318 /* Construct value that describes a mapping between wide characters
319    identified by the string argument PROPERTY.  */
320 extern wctrans_t wctrans_l (__const char *__property, __locale_t __locale)
321      __THROW;
322
323 /* Map the wide character WC using the mapping described by DESC.  */
324 extern wint_t towctrans_l (wint_t __wc, wctrans_t __desc,
325                            __locale_t __locale) __THROW;
326
327 # endif /* Use GNU.  */
328
329 __END_DECLS
330
331 #endif  /* __WCTYPE_H defined.  */
332
333 #endif /* wctype.h  */