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