]> 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 ffa4b25808f63d7c687ccb3be8a11afebe3825a6..1bf4bdfb208bb259f61dc2dcc613e7bb0411c4fd 100644 (file)
-/* Copyright (C) 1996, 1997 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
-#define _WCTYPE_H      1
 
 #include <features.h>
 #include <bits/types.h>
 
-__BEGIN_DECLS
+#ifndef __need_iswxxx
+# define _WCTYPE_H     1
+
+/* Get wint_t from <wchar.h>.  */
+# define __need_wint_t
+# include <wchar.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.  */
-#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;
+/* Constant expression of type `wint_t' whose value does not correspond
+   to any member of the extended character set.  */
+# ifndef WEOF
+#  define WEOF (0xffffffffu)
+# endif
 #endif
+#undef __need_iswxxx
 
-/* Scalar type that can hold values which represent locale-specific
-   character mappings.  */
-typedef __const unsigned int *wctrans_t;
 
+/* The following part is also used in the <wcsmbs.h> header when compiled
+   in the Unix98 compatibility mode.  */
+#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
 
-/* Constant expression of type `wint_t' whose value does not correspond
-   to any member of the extended character set.  */
-#ifndef WEOF
-# define WEOF (0xffffffffu)
-#endif
-
-#ifndef _ISbit
+# ifndef _ISwbit
 /* The characteristics are stored always in network byte order (big
    endian).  We define the bit value interpretations here dependent on the
    machine's byte order.  */
 
-# include <endian.h>
-# if __BYTE_ORDER == __BIG_ENDIAN
-#  define _ISbit(bit)  (1 << bit)
-# else /* __BYTE_ORDER == __LITTLE_ENDIAN */
-#  define _ISbit(bit)  (bit < 8 ? ((1 << bit) << 8) : ((1 << bit) >> 8))
-# endif
+#  include <endian.h>
+#  if __BYTE_ORDER == __BIG_ENDIAN
+#   define _ISwbit(bit)        (1 << (bit))
+#  else /* __BYTE_ORDER == __LITTLE_ENDIAN */
+#   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
 {
-  _ISupper = _ISbit (0),       /* UPPERCASE.  */
-  _ISlower = _ISbit (1),       /* lowercase.  */
-  _ISalpha = _ISbit (2),       /* Alphabetic.  */
-  _ISdigit = _ISbit (3),       /* Numeric.  */
-  _ISxdigit = _ISbit (4),      /* Hexadecimal numeric.  */
-  _ISspace = _ISbit (5),       /* Whitespace.  */
-  _ISprint = _ISbit (6),       /* Printing.  */
-  _ISgraph = _ISbit (7),       /* Graphical.  */
-  _ISblank = _ISbit (8),       /* Blank (usually SPC and TAB).  */
-  _IScntrl = _ISbit (9),       /* Control character.  */
-  _ISpunct = _ISbit (10),      /* Punctuation.  */
-  _ISalnum = _ISbit (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 _ISbit  */
+# 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.
@@ -145,126 +168,126 @@ 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;
+__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));
+extern wint_t towupper (wint_t __wc) __THROW;
+__END_NAMESPACE_C99
+
+__END_DECLS
+
+#endif /* need iswxxx.  */
+
+
+/* The remaining definitions and declarations must not appear in the
+   <wchar.h> header.  */
+#ifdef _WCTYPE_H
 
 /*
  * Extensible wide-character mapping functions: 7.15.3.2.
  */
 
+__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));
-
-
-
-#ifndef        __NO_WCTYPE
-# define iswalnum(wc)  __iswctype ((wc), _ISalnum)
-# define iswalpha(wc)  __iswctype ((wc), _ISalpha)
-# define iswcntrl(wc)  __iswctype ((wc), _IScntrl)
-# define iswdigit(wc)  __iswctype ((wc), _ISdigit)
-# define iswlower(wc)  __iswctype ((wc), _ISlower)
-# define iswgraph(wc)  __iswctype ((wc), _ISgraph)
-# define iswprint(wc)  __iswctype ((wc), _ISprint)
-# define iswpunct(wc)  __iswctype ((wc), _ISpunct)
-# define iswspace(wc)  __iswctype ((wc), _ISspace)
-# define iswupper(wc)  __iswctype ((wc), _ISupper)
-# define iswxdigit(wc) __iswctype ((wc), _ISxdigit)
-
-# ifdef        __USE_GNU
-#  define iswblank(wc) __iswctype ((wc), _ISblank)
-# 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)
+extern wint_t towctrans (wint_t __wc, wctrans_t __desc) __THROW;
+__END_NAMESPACE_C99
 
-#endif /* Not __NO_WCTYPE.  */
-
-#ifdef __USE_GNU
+# ifdef __USE_XOPEN2K8
 /* Declare the interface to extended locale model.  */
-# include <xlocale.h>
+#  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;
 
 
 /*
@@ -272,40 +295,24 @@ 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));
-
-
-# ifndef __NO_WCTYPE
-#  define __iswalnum_l(wc, loc)         __iswctype_l ((wc), _ISalnum, (loc))
-#  define __iswalpha_l(wc, loc)         __iswctype_l ((wc), _ISalpha, (loc))
-#  define __iswcntrl_l(wc, loc)         __iswctype_l ((wc), _IScntrl, (loc))
-#  define __iswdigit_l(wc, loc)         __iswctype_l ((wc), _ISdigit, (loc))
-#  define __iswlower_l(wc, loc)         __iswctype_l ((wc), _ISlower, (loc))
-#  define __iswgraph_l(wc, loc)         __iswctype_l ((wc), _ISgraph, (loc))
-#  define __iswprint_l(wc, loc)         __iswctype_l ((wc), _ISprint, (loc))
-#  define __iswpunct_l(wc, loc)         __iswctype_l ((wc), _ISpunct, (loc))
-#  define __iswspace_l(wc, loc)         __iswctype_l ((wc), _ISspace, (loc))
-#  define __iswupper_l(wc, loc)         __iswctype_l ((wc), _ISupper, (loc))
-#  define __iswxdigit_l(wc, loc) __iswctype_l ((wc), _ISxdigit, (loc))
+extern wint_t towupper_l (wint_t __wc, __locale_t __locale) __THROW;
 
-#  define __iswblank_l(wc, loc)         __iswctype_l ((wc), _ISblank, (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
 
+#endif /* __WCTYPE_H defined.  */
+
 #endif /* wctype.h  */