Merged revisions 82194 via svnmerge from

svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r82194 | stefan.krah | 2010-06-24 12:25:08 +0200 (Thu, 24 Jun 2010) | 3 lines

  Add specification for the Py_IS* macros in pyctype.h.
........

diff --git a/Include/pyctype.h b/Include/pyctype.h
index 0d211ec799c77b80a0b935ef2d18f86640a918fd..c5cc61431d08e0cc8e3b58511b4d618b154c42de 100644 (file)
--- a/Include/pyctype.h
+++ b/Include/pyctype.h
@@ -11,6 +11,9 @@
 
 extern const unsigned int _Py_ctype_table[256];
 
+/* Unlike their C counterparts, the following macros are not meant to
+ * handle an int with any of the values [EOF, 0-UCHAR_MAX]. The argument
+ * must be a signed/unsigned char. */
 #define Py_ISLOWER(c)  (_Py_ctype_table[Py_CHARMASK(c)] & PY_CTF_LOWER)
 #define Py_ISUPPER(c)  (_Py_ctype_table[Py_CHARMASK(c)] & PY_CTF_UPPER)
 #define Py_ISALPHA(c)  (_Py_ctype_table[Py_CHARMASK(c)] & PY_CTF_ALPHA)