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 libc_hidden_proto(iswspace)
 161
 162 /* Test for any wide character that corresponds to an uppercase letter
 163    or is one of a locale-specific set of wide character for which none
 164    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 165 extern int iswupper (wint_t __wc) __THROW;
 166 libc_hidden_proto(iswupper)
 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 libc_hidden_proto(wctype)
 188
 189 /* Determine whether the wide-character WC has the property described by
 190    DESC.  */
 191 extern int iswctype (wint_t __wc, wctype_t __desc) __THROW;
 192 libc_hidden_proto(iswctype)
 193 __END_NAMESPACE_C99
 194
 195
 196 /*
 197  * Wide-character case-mapping functions: 7.15.3.1.
 198  */
 199
 200 __BEGIN_NAMESPACE_C99
 201 /* Scalar type that can hold values which represent locale-specific
 202    character mappings.  */
 203 /* uClibc note: glibc uses - typedef __const __int32_t *wctrans_t; */
 204 typedef unsigned int wctrans_t;
 205 __END_NAMESPACE_C99
 206 #ifdef __USE_GNU
 207 __USING_NAMESPACE_C99(wctrans_t)
 208 #endif
 209
 210 __BEGIN_NAMESPACE_C99
 211 /* Converts an uppercase letter to the corresponding lowercase letter.  */
 212 extern wint_t towlower (wint_t __wc) __THROW;
 213 libc_hidden_proto(towlower)
 214
 215 /* Converts an lowercase letter to the corresponding uppercase letter.  */
 216 extern wint_t towupper (wint_t __wc) __THROW;
 217 libc_hidden_proto(towupper)
 218 __END_NAMESPACE_C99
 219
 220 __END_DECLS
 221
 222 #endif  /* need iswxxx.  */
 223
 224
 225 /* The remaining definitions and declarations must not appear in the
 226    <wcsmbs.h> header.  */
 227 #ifdef _WCTYPE_H
 228
 229 /*
 230  * Extensible wide-character mapping functions: 7.15.3.2.
 231  */
 232
 233 __BEGIN_DECLS
 234
 235 __BEGIN_NAMESPACE_C99
 236 /* Construct value that describes a mapping between wide characters
 237    identified by the string argument PROPERTY.  */
 238 extern wctrans_t wctrans (__const char *__property) __THROW;
 239 libc_hidden_proto(wctrans)
 240
 241 /* Map the wide character WC using the mapping described by DESC.  */
 242 extern wint_t towctrans (wint_t __wc, wctrans_t __desc) __THROW;
 243 libc_hidden_proto(towctrans)
 244 __END_NAMESPACE_C99
 245
 246 #if defined(__USE_GNU) && defined(__UCLIBC_HAS_XLOCALE__)
 247 /* Declare the interface to extended locale model.  */
 248 #  include <xlocale.h>
 249
 250 /* Test for any wide character for which `iswalpha' or `iswdigit' is
 251    true.  */
 252 extern int iswalnum_l (wint_t __wc, __locale_t __locale) __THROW;
 253
 254 /* Test for any wide character for which `iswupper' or 'iswlower' is
 255    true, or any wide character that is one of a locale-specific set of
 256    wide-characters for which none of `iswcntrl', `iswdigit',
 257    `iswpunct', or `iswspace' is true.  */
 258 extern int iswalpha_l (wint_t __wc, __locale_t __locale) __THROW;
 259
 260 /* Test for any control wide character.  */
 261 extern int iswcntrl_l (wint_t __wc, __locale_t __locale) __THROW;
 262
 263 /* Test for any wide character that corresponds to a decimal-digit
 264    character.  */
 265 extern int iswdigit_l (wint_t __wc, __locale_t __locale) __THROW;
 266
 267 /* Test for any wide character for which `iswprint' is true and
 268    `iswspace' is false.  */
 269 extern int iswgraph_l (wint_t __wc, __locale_t __locale) __THROW;
 270
 271 /* Test for any wide character that corresponds to a lowercase letter
 272    or is one of a locale-specific set of wide characters for which
 273    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 274 extern int iswlower_l (wint_t __wc, __locale_t __locale) __THROW;
 275
 276 /* Test for any printing wide character.  */
 277 extern int iswprint_l (wint_t __wc, __locale_t __locale) __THROW;
 278
 279 /* Test for any printing wide character that is one of a
 280    locale-specific et of wide characters for which neither `iswspace'
 281    nor `iswalnum' is true.  */
 282 extern int iswpunct_l (wint_t __wc, __locale_t __locale) __THROW;
 283
 284 /* Test for any wide character that corresponds to a locale-specific
 285    set of wide characters for which none of `iswalnum', `iswgraph', or
 286    `iswpunct' is true.  */
 287 extern int iswspace_l (wint_t __wc, __locale_t __locale) __THROW;
 288 libc_hidden_proto(iswspace_l)
 289
 290 /* Test for any wide character that corresponds to an uppercase letter
 291    or is one of a locale-specific set of wide character for which none
 292    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
 293 extern int iswupper_l (wint_t __wc, __locale_t __locale) __THROW;
 294
 295 /* Test for any wide character that corresponds to a hexadecimal-digit
 296    character equivalent to that performed be the functions described
 297    in the previous subclause.  */
 298 extern int iswxdigit_l (wint_t __wc, __locale_t __locale) __THROW;
 299
 300 /* Test for any wide character that corresponds to a standard blank
 301    wide character or a locale-specific set of wide characters for
 302    which `iswalnum' is false.  */
 303 extern int iswblank_l (wint_t __wc, __locale_t __locale) __THROW;
 304
 305 /* Construct value that describes a class of wide characters identified
 306    by the string argument PROPERTY.  */
 307 extern wctype_t wctype_l (__const char *__property, __locale_t __locale)
 308      __THROW;
 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  */