include/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, 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 # else
 105 #  if defined(__UCLIBC_MJN3_ONLY__) && defined(L_iswctype)
 106 #warning remove _ISwbit already defined check?
 107 #error _ISwbit already defined!
 108 #  endif
 109 # endif /* Not _ISwbit  */
 110
 111
 112 __BEGIN_DECLS
 113
 114 __BEGIN_NAMESPACE_C99
 115 /*
 116  * Wide-character classification functions: 7.15.2.1.
 117  */
 118
 119 /* Test for any wide character for which `iswalpha' or `iswdigit' is
 120    true.  */
 121 extern int iswalnum (wint_t __wc) __THROW;
 122 libc_hidden_proto(iswalnum)
 123
 124 /* Test for any wide character for which `iswupper' or 'iswlower' is
 125    true, or any wide character that is one of a locale-specific set of
 126    wide-characters for which none of `iswcntrl', `iswdigit',
 127    `iswpunct', or `iswspace' is true.  */
 128 extern int iswalpha (wint_t __wc) __THROW;
 129
 130 /* Test for any control wide character.  */
 131 extern int iswcntrl (wint_t __wc) __THROW;
 132
 133 /* Test for any wide character that corresponds to a decimal-digit
 134    character.  */
 135 extern int iswdigit (wint_t __wc) __THROW;
 136
 137 /* Test for any wide character for which `iswprint' is true and
 138    `iswspace' is false.  */
 139 extern int iswgraph (wint_t __wc) __THROW;
 140
 141 /* Test for any wide character that corresponds to a lowercase letter
 142    or is one of a locale-specific set of wide characters for which
 143    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 144 extern int iswlower (wint_t __wc) __THROW;
 145 libc_hidden_proto(iswlower)
 146
 147 /* Test for any printing wide character.  */
 148 extern int iswprint (wint_t __wc) __THROW;
 149
 150 /* Test for any printing wide character that is one of a
 151    locale-specific et of wide characters for which neither `iswspace'
 152    nor `iswalnum' is true.  */
 153 extern int iswpunct (wint_t __wc) __THROW;
 154
 155 /* Test for any wide character that corresponds to a locale-specific
 156    set of wide characters for which none of `iswalnum', `iswgraph', or
 157    `iswpunct' is true.  */
 158 extern int iswspace (wint_t __wc) __THROW;
 159 libc_hidden_proto(iswspace)
 160
 161 /* Test for any wide character that corresponds to an uppercase letter
 162    or is one of a locale-specific set of wide character for which none
 163    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 164 extern int iswupper (wint_t __wc) __THROW;
 165 libc_hidden_proto(iswupper)
 166
 167 /* Test for any wide character that corresponds to a hexadecimal-digit
 168    character equivalent to that performed be the functions described
 169    in the previous subclause.  */
 170 extern int iswxdigit (wint_t __wc) __THROW;
 171
 172 /* Test for any wide character that corresponds to a standard blank
 173    wide character or a locale-specific set of wide characters for
 174    which `iswalnum' is false.  */
 175 # ifdef __USE_ISOC99
 176 extern int iswblank (wint_t __wc) __THROW;
 177 # endif
 178
 179 /*
 180  * Extensible wide-character classification functions: 7.15.2.2.
 181  */
 182
 183 /* Construct value that describes a class of wide characters identified
 184    by the string argument PROPERTY.  */
 185 extern wctype_t wctype (const char *__property) __THROW;
 186 libc_hidden_proto(wctype)
 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 libc_hidden_proto(iswctype)
 192 __END_NAMESPACE_C99
 193
 194
 195 /*
 196  * Wide-character case-mapping functions: 7.15.3.1.
 197  */
 198
 199 __BEGIN_NAMESPACE_C99
 200 /* Scalar type that can hold values which represent locale-specific
 201    character mappings.  */
 202 /* uClibc note: glibc uses - typedef const __int32_t *wctrans_t; */
 203 typedef unsigned int wctrans_t;
 204 __END_NAMESPACE_C99
 205 #ifdef __USE_GNU
 206 __USING_NAMESPACE_C99(wctrans_t)
 207 #endif
 208
 209 __BEGIN_NAMESPACE_C99
 210 /* Converts an uppercase letter to the corresponding lowercase letter.  */
 211 extern wint_t towlower (wint_t __wc) __THROW;
 212 libc_hidden_proto(towlower)
 213
 214 /* Converts an lowercase letter to the corresponding uppercase letter.  */
 215 extern wint_t towupper (wint_t __wc) __THROW;
 216 libc_hidden_proto(towupper)
 217 __END_NAMESPACE_C99
 218
 219 __END_DECLS
 220
 221 #endif  /* need iswxxx.  */
 222
 223
 224 /* The remaining definitions and declarations must not appear in the
 225    <wcsmbs.h> header.  */
 226 #ifdef _WCTYPE_H
 227
 228 /*
 229  * Extensible wide-character mapping functions: 7.15.3.2.
 230  */
 231
 232 __BEGIN_DECLS
 233
 234 __BEGIN_NAMESPACE_C99
 235 /* Construct value that describes a mapping between wide characters
 236    identified by the string argument PROPERTY.  */
 237 extern wctrans_t wctrans (const char *__property) __THROW;
 238 libc_hidden_proto(wctrans)
 239
 240 /* Map the wide character WC using the mapping described by DESC.  */
 241 extern wint_t towctrans (wint_t __wc, wctrans_t __desc) __THROW;
 242 libc_hidden_proto(towctrans)
 243 __END_NAMESPACE_C99
 244
 245 #if defined(__USE_GNU) && defined(__UCLIBC_HAS_XLOCALE__)
 246 /* Declare the interface to extended locale model.  */
 247 #  include <xlocale.h>
 248
 249 /* Test for any wide character for which `iswalpha' or `iswdigit' is
 250    true.  */
 251 extern int iswalnum_l (wint_t __wc, __locale_t __locale) __THROW;
 252
 253 /* Test for any wide character for which `iswupper' or 'iswlower' is
 254    true, or any wide character that is one of a locale-specific set of
 255    wide-characters for which none of `iswcntrl', `iswdigit',
 256    `iswpunct', or `iswspace' is true.  */
 257 extern int iswalpha_l (wint_t __wc, __locale_t __locale) __THROW;
 258
 259 /* Test for any control wide character.  */
 260 extern int iswcntrl_l (wint_t __wc, __locale_t __locale) __THROW;
 261
 262 /* Test for any wide character that corresponds to a decimal-digit
 263    character.  */
 264 extern int iswdigit_l (wint_t __wc, __locale_t __locale) __THROW;
 265
 266 /* Test for any wide character for which `iswprint' is true and
 267    `iswspace' is false.  */
 268 extern int iswgraph_l (wint_t __wc, __locale_t __locale) __THROW;
 269
 270 /* Test for any wide character that corresponds to a lowercase letter
 271    or is one of a locale-specific set of wide characters for which
 272    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 273 extern int iswlower_l (wint_t __wc, __locale_t __locale) __THROW;
 274
 275 /* Test for any printing wide character.  */
 276 extern int iswprint_l (wint_t __wc, __locale_t __locale) __THROW;
 277
 278 /* Test for any printing wide character that is one of a
 279    locale-specific et of wide characters for which neither `iswspace'
 280    nor `iswalnum' is true.  */
 281 extern int iswpunct_l (wint_t __wc, __locale_t __locale) __THROW;
 282
 283 /* Test for any wide character that corresponds to a locale-specific
 284    set of wide characters for which none of `iswalnum', `iswgraph', or
 285    `iswpunct' is true.  */
 286 extern int iswspace_l (wint_t __wc, __locale_t __locale) __THROW;
 287 libc_hidden_proto(iswspace_l)
 288
 289 /* Test for any wide character that corresponds to an uppercase letter
 290    or is one of a locale-specific set of wide character for which none
 291    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 292 extern int iswupper_l (wint_t __wc, __locale_t __locale) __THROW;
 293
 294 /* Test for any wide character that corresponds to a hexadecimal-digit
 295    character equivalent to that performed be the functions described
 296    in the previous subclause.  */
 297 extern int iswxdigit_l (wint_t __wc, __locale_t __locale) __THROW;
 298
 299 /* Test for any wide character that corresponds to a standard blank
 300    wide character or a locale-specific set of wide characters for
 301    which `iswalnum' is false.  */
 302 extern int iswblank_l (wint_t __wc, __locale_t __locale) __THROW;
 303
 304 /* Construct value that describes a class of wide characters identified
 305    by the string argument PROPERTY.  */
 306 extern wctype_t wctype_l (const char *__property, __locale_t __locale)
 307      __THROW;
 308
 309 /* Determine whether the wide-character WC has the property described by
 310    DESC.  */
 311 extern int iswctype_l (wint_t __wc, wctype_t __desc, __locale_t __locale)
 312      __THROW;
 313 libc_hidden_proto(iswctype_l)
 314
 315
 316 /*
 317  * Wide-character case-mapping functions.
 318  */
 319
 320 /* Converts an uppercase letter to the corresponding lowercase letter.  */
 321 extern wint_t towlower_l (wint_t __wc, __locale_t __locale) __THROW;
 322 libc_hidden_proto(towlower_l)
 323
 324 /* Converts an lowercase letter to the corresponding uppercase letter.  */
 325 extern wint_t towupper_l (wint_t __wc, __locale_t __locale) __THROW;
 326 libc_hidden_proto(towupper_l)
 327
 328 /* Construct value that describes a mapping between wide characters
 329    identified by the string argument PROPERTY.  */
 330 extern wctrans_t wctrans_l (const char *__property, __locale_t __locale)
 331      __THROW;
 332
 333 /* Map the wide character WC using the mapping described by DESC.  */
 334 extern wint_t towctrans_l (wint_t __wc, wctrans_t __desc,
 335                            __locale_t __locale) __THROW;
 336 libc_hidden_proto(towctrans_l)
 337
 338 # endif /* Use GNU.  */
 339
 340 __END_DECLS
 341
 342 #endif  /* __WCTYPE_H defined.  */
 343
 344 #endif /* wctype.h  */