]> git.ipfire.org Git - thirdparty/glibc.git/blobdiff - wctype/wctype.h
Update copyright dates with scripts/update-copyrights.
[thirdparty/glibc.git] / wctype / wctype.h
index 2ed0fe1f35151bb1c455ccb24e183a0b775372d1..1bf4bdfb208bb259f61dc2dcc613e7bb0411c4fd 100644 (file)
@@ -1,46 +1,36 @@
-/* Copyright (C) 1996, 1997, 1998 Free Software Foundation, Inc.
+/* Copyright (C) 1996-2015 Free Software Foundation, Inc.
    This file is part of the GNU C Library.
 
    The GNU C Library is free software; you can redistribute it and/or
-   modify it under the terms of the GNU Library General Public License as
-   published by the Free Software Foundation; either version 2 of the
-   License, or (at your option) any later version.
+   modify it under the terms of the GNU Lesser General Public
+   License as published by the Free Software Foundation; either
+   version 2.1 of the License, or (at your option) any later version.
 
    The GNU C Library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-   Library General Public License for more details.
+   Lesser General Public License for more details.
 
-   You should have received a copy of the GNU Library General Public
-   License along with the GNU C Library; see the file COPYING.LIB.  If not,
-   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-   Boston, MA 02111-1307, USA.  */
+   You should have received a copy of the GNU Lesser General Public
+   License along with the GNU C Library; if not, see
+   <http://www.gnu.org/licenses/>.  */
 
 /*
- *     ISO C Standard, Amendment 1, 7.15:
- *     Wide-character classification and mapping utilities  <wctype.h>
+ *     ISO C99 Standard: 7.25
+ *     Wide character classification and mapping utilities  <wctype.h>
  */
 
 #ifndef _WCTYPE_H
 
+#include <features.h>
+#include <bits/types.h>
+
 #ifndef __need_iswxxx
 # define _WCTYPE_H     1
 
-# include <features.h>
-# include <bits/types.h>
-
-/* We try to get wint_t from <stddef.h>, but not all GCC versions define it
-   there.  So define it ourselves if it remains undefined.  */
+/* Get wint_t from <wchar.h>.  */
 # define __need_wint_t
-# include <stddef.h>
-# ifndef _WINT_T
-/* Integral type unchanged by default argument promotions that can
-   hold any value corresponding to members of the extended character
-   set, as well as at least one value that does not correspond to any
-   member of the extended character set.  */
-#  define _WINT_T
-typedef unsigned int wint_t;
-# endif
+# include <wchar.h>
 
 /* Constant expression of type `wint_t' whose value does not correspond
    to any member of the extended character set.  */
@@ -56,9 +46,11 @@ typedef unsigned int wint_t;
 #ifndef __iswxxx_defined
 # define __iswxxx_defined      1
 
+__BEGIN_NAMESPACE_C99
 /* Scalar type that can hold values which represent locale-specific
    character classifications.  */
 typedef unsigned long int wctype_t;
+__END_NAMESPACE_C99
 
 # ifndef _ISwbit
 /* The characteristics are stored always in network byte order (big
@@ -67,83 +59,108 @@ typedef unsigned long int wctype_t;
 
 #  include <endian.h>
 #  if __BYTE_ORDER == __BIG_ENDIAN
-#   define _ISwbit(bit)        (1 << bit)
+#   define _ISwbit(bit)        (1 << (bit))
 #  else /* __BYTE_ORDER == __LITTLE_ENDIAN */
-#   define _ISwbit(bit)        (bit < 8 ? 1UL << bit << 24 : 1UL << (bit + 8))
+#   define _ISwbit(bit)        \
+       ((bit) < 8 ? (int) ((1UL << (bit)) << 24)                             \
+        : ((bit) < 16 ? (int) ((1UL << (bit)) << 8)                          \
+           : ((bit) < 24 ? (int) ((1UL << (bit)) >> 8)                       \
+              : (int) ((1UL << (bit)) >> 24))))
 #  endif
 
 enum
 {
-  _ISwupper = _ISwbit (0),     /* UPPERCASE.  */
-  _ISwlower = _ISwbit (1),     /* lowercase.  */
-  _ISwalpha = _ISwbit (2),     /* Alphabetic.  */
-  _ISwdigit = _ISwbit (3),     /* Numeric.  */
-  _ISwxdigit = _ISwbit (4),    /* Hexadecimal numeric.  */
-  _ISwspace = _ISwbit (5),     /* Whitespace.  */
-  _ISwprint = _ISwbit (6),     /* Printing.  */
-  _ISwgraph = _ISwbit (7),     /* Graphical.  */
-  _ISwblank = _ISwbit (8),     /* Blank (usually SPC and TAB).  */
-  _ISwcntrl = _ISwbit (9),     /* Control character.  */
-  _ISwpunct = _ISwbit (10),    /* Punctuation.  */
-  _ISwalnum = _ISwbit (11)     /* Alphanumeric.  */
+  __ISwupper = 0,                      /* UPPERCASE.  */
+  __ISwlower = 1,                      /* lowercase.  */
+  __ISwalpha = 2,                      /* Alphabetic.  */
+  __ISwdigit = 3,                      /* Numeric.  */
+  __ISwxdigit = 4,                     /* Hexadecimal numeric.  */
+  __ISwspace = 5,                      /* Whitespace.  */
+  __ISwprint = 6,                      /* Printing.  */
+  __ISwgraph = 7,                      /* Graphical.  */
+  __ISwblank = 8,                      /* Blank (usually SPC and TAB).  */
+  __ISwcntrl = 9,                      /* Control character.  */
+  __ISwpunct = 10,                     /* Punctuation.  */
+  __ISwalnum = 11,                     /* Alphanumeric.  */
+
+  _ISwupper = _ISwbit (__ISwupper),    /* UPPERCASE.  */
+  _ISwlower = _ISwbit (__ISwlower),    /* lowercase.  */
+  _ISwalpha = _ISwbit (__ISwalpha),    /* Alphabetic.  */
+  _ISwdigit = _ISwbit (__ISwdigit),    /* Numeric.  */
+  _ISwxdigit = _ISwbit (__ISwxdigit),  /* Hexadecimal numeric.  */
+  _ISwspace = _ISwbit (__ISwspace),    /* Whitespace.  */
+  _ISwprint = _ISwbit (__ISwprint),    /* Printing.  */
+  _ISwgraph = _ISwbit (__ISwgraph),    /* Graphical.  */
+  _ISwblank = _ISwbit (__ISwblank),    /* Blank (usually SPC and TAB).  */
+  _ISwcntrl = _ISwbit (__ISwcntrl),    /* Control character.  */
+  _ISwpunct = _ISwbit (__ISwpunct),    /* Punctuation.  */
+  _ISwalnum = _ISwbit (__ISwalnum)     /* Alphanumeric.  */
 };
 # endif /* Not _ISwbit  */
 
 
 __BEGIN_DECLS
 
+__BEGIN_NAMESPACE_C99
 /*
  * Wide-character classification functions: 7.15.2.1.
  */
 
 /* Test for any wide character for which `iswalpha' or `iswdigit' is
    true.  */
-extern int iswalnum __P ((wint_t __wc));
+extern int iswalnum (wint_t __wc) __THROW;
 
 /* Test for any wide character for which `iswupper' or 'iswlower' is
    true, or any wide character that is one of a locale-specific set of
    wide-characters for which none of `iswcntrl', `iswdigit',
    `iswpunct', or `iswspace' is true.  */
-extern int iswalpha __P ((wint_t __wc));
+extern int iswalpha (wint_t __wc) __THROW;
 
 /* Test for any control wide character.  */
-extern int iswcntrl __P ((wint_t __wc));
+extern int iswcntrl (wint_t __wc) __THROW;
 
 /* Test for any wide character that corresponds to a decimal-digit
    character.  */
-extern int iswdigit __P ((wint_t __wc));
+extern int iswdigit (wint_t __wc) __THROW;
 
 /* Test for any wide character for which `iswprint' is true and
    `iswspace' is false.  */
-extern int iswgraph __P ((wint_t __wc));
+extern int iswgraph (wint_t __wc) __THROW;
 
 /* Test for any wide character that corresponds to a lowercase letter
    or is one of a locale-specific set of wide characters for which
    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
-extern int iswlower __P ((wint_t __wc));
+extern int iswlower (wint_t __wc) __THROW;
 
 /* Test for any printing wide character.  */
-extern int iswprint __P ((wint_t __wc));
+extern int iswprint (wint_t __wc) __THROW;
 
 /* Test for any printing wide character that is one of a
    locale-specific et of wide characters for which neither `iswspace'
    nor `iswalnum' is true.  */
-extern int iswpunct __P ((wint_t __wc));
+extern int iswpunct (wint_t __wc) __THROW;
 
 /* Test for any wide character that corresponds to a locale-specific
    set of wide characters for which none of `iswalnum', `iswgraph', or
    `iswpunct' is true.  */
-extern int iswspace __P ((wint_t __wc));
+extern int iswspace (wint_t __wc) __THROW;
 
 /* Test for any wide character that corresponds to an uppercase letter
    or is one of a locale-specific set of wide character for which none
    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
-extern int iswupper __P ((wint_t __wc));
+extern int iswupper (wint_t __wc) __THROW;
 
 /* Test for any wide character that corresponds to a hexadecimal-digit
    character equivalent to that performed be the functions described
    in the previous subclause.  */
-extern int iswxdigit __P ((wint_t __wc));
+extern int iswxdigit (wint_t __wc) __THROW;
+
+/* Test for any wide character that corresponds to a standard blank
+   wide character or a locale-specific set of wide characters for
+   which `iswalnum' is false.  */
+# ifdef __USE_ISOC99
+extern int iswblank (wint_t __wc) __THROW;
+# endif
 
 /*
  * Extensible wide-character classification functions: 7.15.2.2.
@@ -151,58 +168,34 @@ extern int iswxdigit __P ((wint_t __wc));
 
 /* Construct value that describes a class of wide characters identified
    by the string argument PROPERTY.  */
-extern wctype_t wctype __P ((__const char *__property));
+extern wctype_t wctype (const char *__property) __THROW;
 
 /* Determine whether the wide-character WC has the property described by
    DESC.  */
-extern int __iswctype __P ((wint_t __wc, wctype_t __desc));
-extern int iswctype __P ((wint_t __wc, wctype_t __desc));
+extern int iswctype (wint_t __wc, wctype_t __desc) __THROW;
+__END_NAMESPACE_C99
 
 
 /*
  * Wide-character case-mapping functions: 7.15.3.1.
  */
 
+__BEGIN_NAMESPACE_C99
 /* Scalar type that can hold values which represent locale-specific
    character mappings.  */
-typedef __const __int32_t *wctrans_t;
+typedef const __int32_t *wctrans_t;
+__END_NAMESPACE_C99
+#ifdef __USE_GNU
+__USING_NAMESPACE_C99(wctrans_t)
+#endif
 
+__BEGIN_NAMESPACE_C99
 /* Converts an uppercase letter to the corresponding lowercase letter.  */
-extern wint_t towlower __P ((wint_t __wc));
+extern wint_t towlower (wint_t __wc) __THROW;
 
 /* Converts an lowercase letter to the corresponding uppercase letter.  */
-extern wint_t towupper __P ((wint_t __wc));
-
-/* Map the wide character WC using the mapping described by DESC.  */
-extern wint_t __towctrans __P ((wint_t __wc, wctrans_t __desc));
-
-
-# ifndef __NO_WCTYPE
-#  define iswalnum(wc) __iswctype ((wc), _ISwalnum)
-#  define iswalpha(wc) __iswctype ((wc), _ISwalpha)
-#  define iswcntrl(wc) __iswctype ((wc), _ISwcntrl)
-#  define iswdigit(wc) __iswctype ((wc), _ISwdigit)
-#  define iswlower(wc) __iswctype ((wc), _ISwlower)
-#  define iswgraph(wc) __iswctype ((wc), _ISwgraph)
-#  define iswprint(wc) __iswctype ((wc), _ISwprint)
-#  define iswpunct(wc) __iswctype ((wc), _ISwpunct)
-#  define iswspace(wc) __iswctype ((wc), _ISwspace)
-#  define iswupper(wc) __iswctype ((wc), _ISwupper)
-#  define iswxdigit(wc)        __iswctype ((wc), _ISwxdigit)
-
-#  ifdef __USE_GNU
-#   define iswblank(wc)        __iswctype ((wc), _ISwblank)
-#  endif
-
-
-/* Pointer to conversion tables.  */
-extern __const __int32_t *__ctype_tolower; /* Case conversions.  */
-extern __const __int32_t *__ctype_toupper; /* Case conversions.  */
-
-#  define towlower(wc) __towctrans ((wc), __ctype_tolower)
-#  define towupper(wc) __towctrans ((wc), __ctype_toupper)
-
-# endif /* Not __NO_WCTYPE.  */
+extern wint_t towupper (wint_t __wc) __THROW;
+__END_NAMESPACE_C99
 
 __END_DECLS
 
@@ -210,7 +203,7 @@ __END_DECLS
 
 
 /* The remaining definitions and declarations must not appear in the
-   <wcsmbs.h> header.  */
+   <wchar.h> header.  */
 #ifdef _WCTYPE_H
 
 /*
@@ -219,76 +212,82 @@ __END_DECLS
 
 __BEGIN_DECLS
 
+__BEGIN_NAMESPACE_C99
 /* Construct value that describes a mapping between wide characters
    identified by the string argument PROPERTY.  */
-extern wctrans_t wctrans __P ((__const char *__property));
+extern wctrans_t wctrans (const char *__property) __THROW;
 
 /* Map the wide character WC using the mapping described by DESC.  */
-extern wint_t towctrans __P ((wint_t __wc, wctrans_t __desc));
+extern wint_t towctrans (wint_t __wc, wctrans_t __desc) __THROW;
+__END_NAMESPACE_C99
 
-# ifdef __USE_GNU
+# ifdef __USE_XOPEN2K8
 /* Declare the interface to extended locale model.  */
 #  include <xlocale.h>
 
 /* Test for any wide character for which `iswalpha' or `iswdigit' is
    true.  */
-extern int __iswalnum_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswalnum_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any wide character for which `iswupper' or 'iswlower' is
    true, or any wide character that is one of a locale-specific set of
    wide-characters for which none of `iswcntrl', `iswdigit',
    `iswpunct', or `iswspace' is true.  */
-extern int __iswalpha_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswalpha_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any control wide character.  */
-extern int __iswcntrl_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswcntrl_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any wide character that corresponds to a decimal-digit
    character.  */
-extern int __iswdigit_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswdigit_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any wide character for which `iswprint' is true and
    `iswspace' is false.  */
-extern int __iswgraph_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswgraph_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any wide character that corresponds to a lowercase letter
    or is one of a locale-specific set of wide characters for which
    none of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
-extern int __iswlower_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswlower_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any printing wide character.  */
-extern int __iswprint_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswprint_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any printing wide character that is one of a
    locale-specific et of wide characters for which neither `iswspace'
    nor `iswalnum' is true.  */
-extern int __iswpunct_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswpunct_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any wide character that corresponds to a locale-specific
    set of wide characters for which none of `iswalnum', `iswgraph', or
    `iswpunct' is true.  */
-extern int __iswspace_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswspace_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any wide character that corresponds to an uppercase letter
    or is one of a locale-specific set of wide character for which none
    of `iswcntrl', `iswdigit', `iswpunct', or `iswspace' is true.  */
-extern int __iswupper_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswupper_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Test for any wide character that corresponds to a hexadecimal-digit
    character equivalent to that performed be the functions described
    in the previous subclause.  */
-extern int __iswxdigit_l __P ((wint_t __wc, __locale_t __locale));
+extern int iswxdigit_l (wint_t __wc, __locale_t __locale) __THROW;
 
+/* Test for any wide character that corresponds to a standard blank
+   wide character or a locale-specific set of wide characters for
+   which `iswalnum' is false.  */
+extern int iswblank_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Construct value that describes a class of wide characters identified
    by the string argument PROPERTY.  */
-extern wctype_t __wctype_l __P ((__const char *__property,
-                                __locale_t __locale));
+extern wctype_t wctype_l (const char *__property, __locale_t __locale)
+     __THROW;
 
 /* Determine whether the wide-character WC has the property described by
    DESC.  */
-extern int __iswctype_l __P ((wint_t __wc, wctype_t __desc,
-                             __locale_t __locale));
+extern int iswctype_l (wint_t __wc, wctype_t __desc, __locale_t __locale)
+     __THROW;
 
 
 /*
@@ -296,39 +295,21 @@ extern int __iswctype_l __P ((wint_t __wc, wctype_t __desc,
  */
 
 /* Converts an uppercase letter to the corresponding lowercase letter.  */
-extern wint_t __towlower_l __P ((wint_t __wc, __locale_t __locale));
+extern wint_t towlower_l (wint_t __wc, __locale_t __locale) __THROW;
 
 /* Converts an lowercase letter to the corresponding uppercase letter.  */
-extern wint_t __towupper_l __P ((wint_t __wc, __locale_t __locale));
-
-/* Map the wide character WC using the mapping described by DESC.  */
-extern wint_t __towctrans_l __P ((wint_t __wc, wctrans_t __desc,
-                                 __locale_t __locale));
-
+extern wint_t towupper_l (wint_t __wc, __locale_t __locale) __THROW;
 
-#  ifndef __NO_WCTYPE
-#   define __iswalnum_l(wc, loc) __iswctype_l ((wc), _ISwalnum, (loc))
-#   define __iswalpha_l(wc, loc) __iswctype_l ((wc), _ISwalpha, (loc))
-#   define __iswcntrl_l(wc, loc) __iswctype_l ((wc), _ISwcntrl, (loc))
-#   define __iswdigit_l(wc, loc) __iswctype_l ((wc), _ISwdigit, (loc))
-#   define __iswlower_l(wc, loc) __iswctype_l ((wc), _ISwlower, (loc))
-#   define __iswgraph_l(wc, loc) __iswctype_l ((wc), _ISwgraph, (loc))
-#   define __iswprint_l(wc, loc) __iswctype_l ((wc), _ISwprint, (loc))
-#   define __iswpunct_l(wc, loc) __iswctype_l ((wc), _ISwpunct, (loc))
-#   define __iswspace_l(wc, loc) __iswctype_l ((wc), _ISwspace, (loc))
-#   define __iswupper_l(wc, loc) __iswctype_l ((wc), _ISwupper, (loc))
-#   define __iswxdigit_l(wc, loc) __iswctype_l ((wc), _ISwxdigit, (loc))
-
-#   define __iswblank_l(wc, loc) __iswctype_l ((wc), _ISwblank, (loc))
-
-#   define __towlower_l(wc, loc) __towctrans_l ((wc), (loc)->__ctype_tolower, \
-                                               (loc))
-#   define __towupper_l(wc, loc) __towctrans_l ((wc), (loc)->__ctype_toupper, \
-                                               (loc))
+/* Construct value that describes a mapping between wide characters
+   identified by the string argument PROPERTY.  */
+extern wctrans_t wctrans_l (const char *__property, __locale_t __locale)
+     __THROW;
 
-#  endif /* Not __NO_WCTYPE.  */
+/* Map the wide character WC using the mapping described by DESC.  */
+extern wint_t towctrans_l (wint_t __wc, wctrans_t __desc,
+                          __locale_t __locale) __THROW;
 
-# endif /* Use GNU.  */
+# endif /* Use POSIX 2008.  */
 
 __END_DECLS