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, 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 __UCLIBC_HAS_WCHAR__
  30 #error Attempted to include wctype.h when uClibc built without wide char support.
  31 #endif
  32
  33 #ifndef __need_iswxxx
  34 # define _WCTYPE_H      1
  35
  36 /* We try to get wint_t from <stddef.h>, but not all GCC versions define it
  37    there.  So define it ourselves if it remains undefined.  */
  38 # define __need_wint_t
  39 # include <stddef.h>
  40 # ifndef _WINT_T
  41 /* Integral type unchanged by default argument promotions that can
  42    hold any value corresponding to members of the extended character
  43    set, as well as at least one value that does not correspond to any
  44    member of the extended character set.  */
  45 #  define _WINT_T
  46 typedef unsigned int wint_t;
  47 # else
  48 #  ifdef __USE_ISOC99
  49 __USING_NAMESPACE_C99(wint_t)
  50 #  endif
  51 # endif
  52
  53 /* Constant expression of type `wint_t' whose value does not correspond
  54    to any member of the extended character set.  */
  55 # ifndef WEOF
  56 #  define WEOF (0xffffffffu)
  57 # endif
  58 #endif
  59 #undef __need_iswxxx
  60
  61
  62 /* The following part is also used in the <wcsmbs.h> header when compiled
  63    in the Unix98 compatibility mode.  */
  64 #ifndef __iswxxx_defined
  65 # define __iswxxx_defined       1
  66
  67 __BEGIN_NAMESPACE_C99
  68 /* Scalar type that can hold values which represent locale-specific
  69    character classifications.  */
  70 /* uClibc note: glibc uses - typedef unsigned long int wctype_t; */
  71 typedef unsigned int wctype_t;
  72 __END_NAMESPACE_C99
  73
  74 # ifndef _ISwbit
  75 #  define _ISwbit(bit)  (1 << (bit))
  76
  77 enum
  78 {
  79   __ISwupper = 0,                       /* UPPERCASE.  */
  80   __ISwlower = 1,                       /* lowercase.  */
  81   __ISwalpha = 2,                       /* Alphabetic.  */
  82   __ISwdigit = 3,                       /* Numeric.  */
  83   __ISwxdigit = 4,                      /* Hexadecimal numeric.  */
  84   __ISwspace = 5,                       /* Whitespace.  */
  85   __ISwprint = 6,                       /* Printing.  */
  86   __ISwgraph = 7,                       /* Graphical.  */
  87   __ISwblank = 8,                       /* Blank (usually SPC and TAB).  */
  88   __ISwcntrl = 9,                       /* Control character.  */
  89   __ISwpunct = 10,                      /* Punctuation.  */
  90   __ISwalnum = 11,                      /* Alphanumeric.  */
  91
  92   _ISwupper = _ISwbit (__ISwupper),     /* UPPERCASE.  */
  93   _ISwlower = _ISwbit (__ISwlower),     /* lowercase.  */
  94   _ISwalpha = _ISwbit (__ISwalpha),     /* Alphabetic.  */
  95   _ISwdigit = _ISwbit (__ISwdigit),     /* Numeric.  */
  96   _ISwxdigit = _ISwbit (__ISwxdigit),   /* Hexadecimal numeric.  */
  97   _ISwspace = _ISwbit (__ISwspace),     /* Whitespace.  */
  98   _ISwprint = _ISwbit (__ISwprint),     /* Printing.  */
  99   _ISwgraph = _ISwbit (__ISwgraph),     /* Graphical.  */
 100   _ISwblank = _ISwbit (__ISwblank),     /* Blank (usually SPC and TAB).  */
 101   _ISwcntrl = _ISwbit (__ISwcntrl),     /* Control character.  */
 102   _ISwpunct = _ISwbit (__ISwpunct),     /* Punctuation.  */
 103   _ISwalnum = _ISwbit (__ISwalnum)      /* Alphanumeric.  */
 104 };
 105 # else
 106 #  if defined(__UCLIBC_MJN3_ONLY__) && defined(L_iswctype)
 107 #warning remove _ISwbit already defined check?
 108 #error _ISwbit already defined!
 109 #  endif
 110 # endif /* Not _ISwbit  */
 111
 112
 113 __BEGIN_DECLS
 114
 115 __BEGIN_NAMESPACE_C99
 116 /*
 117  * Wide-character classification functions: 7.15.2.1.
 118  */
 119
 120 /* Test for any wide character for which `iswalpha' or `iswdigit' is
 121    true.  */
 122 extern int iswalnum (wint_t __wc) __THROW;
 123 libc_hidden_proto(iswalnum)
 124
 125 /* Test for any wide character for which `iswupper' or 'iswlower' is
 126    true, or any wide character that is one of a locale-specific set of
 127    wide-characters for which none of `iswcntrl', `iswdigit',
 128    `iswpunct', or `iswspace' is true.  */
 129 extern int iswalpha (wint_t __wc) __THROW;
 130
 131 /* Test for any control wide character.  */
 132 extern int iswcntrl (wint_t __wc) __THROW;
 133
 134 /* Test for any wide character that corresponds to a decimal-digit
 135    character.  */
 136 extern int iswdigit (wint_t __wc) __THROW;
 137
 138 /* Test for any wide character for which `iswprint' is true and
 139    `iswspace' is false.  */
 140 extern int iswgraph (wint_t __wc) __THROW;
 141
 142 /* Test for any wide character that corresponds to a lowercase letter
 143    or is one of a locale-specific set of wide characters for which
 144    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 145 extern int iswlower (wint_t __wc) __THROW;
 146 libc_hidden_proto(iswlower)
 147
 148 /* Test for any printing wide character.  */
 149 extern int iswprint (wint_t __wc) __THROW;
 150
 151 /* Test for any printing wide character that is one of a
 152    locale-specific et of wide characters for which neither `iswspace'
 153    nor `iswalnum' is true.  */
 154 extern int iswpunct (wint_t __wc) __THROW;
 155
 156 /* Test for any wide character that corresponds to a locale-specific
 157    set of wide characters for which none of `iswalnum', `iswgraph', or
 158    `iswpunct' is true.  */
 159 extern int iswspace (wint_t __wc) __THROW;
 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(iswspace)
 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 libc_hidden_proto(wctype_l)
 309
 310 /* Determine whether the wide-character WC has the property described by
 311    DESC.  */
 312 extern int iswctype_l (wint_t __wc, wctype_t __desc, __locale_t __locale)
 313      __THROW;
 314 libc_hidden_proto(iswctype_l)
 315
 316
 317 /*
 318  * Wide-character case-mapping functions.
 319  */
 320
 321 /* Converts an uppercase letter to the corresponding lowercase letter.  */
 322 extern wint_t towlower_l (wint_t __wc, __locale_t __locale) __THROW;
 323 libc_hidden_proto(towlower_l)
 324
 325 /* Converts an lowercase letter to the corresponding uppercase letter.  */
 326 extern wint_t towupper_l (wint_t __wc, __locale_t __locale) __THROW;
 327 libc_hidden_proto(towupper_l)
 328
 329 /* Construct value that describes a mapping between wide characters
 330    identified by the string argument PROPERTY.  */
 331 extern wctrans_t wctrans_l (__const char *__property, __locale_t __locale)
 332      __THROW;
 333
 334 /* Map the wide character WC using the mapping described by DESC.  */
 335 extern wint_t towctrans_l (wint_t __wc, wctrans_t __desc,
 336                            __locale_t __locale) __THROW;
 337 libc_hidden_proto(towctrans_l)
 338
 339 # endif /* Use GNU.  */
 340
 341 __END_DECLS
 342
 343 #endif  /* __WCTYPE_H defined.  */
 344
 345 #endif /* wctype.h  */