From: Stefan Krah <stefan@bytereef.org>
Date: Thu, 24 Jun 2010 10:25:08 +0000 (+0000)
Subject: Add specification for the Py_IS* macros in pyctype.h.
X-Git-Tag: v3.2a1~468
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=2f7105dde7a01b85640aefb92e8131c02c82e954;p=python

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

diff --git a/Include/pyctype.h b/Include/pyctype.h
index 0d211ec799..c5cc61431d 100644
--- 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)