| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 1 | #ifndef Py_PYPORT_H | 
| Vladimir Marangozov | 14a4d88 | 2000-07-10 04:59:49 +0000 | [diff] [blame] | 2 | #define Py_PYPORT_H | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 3 |  | 
| Martin v. Löwis | 4f1cd8b | 2001-07-26 13:41:06 +0000 | [diff] [blame] | 4 | #include "pyconfig.h" /* include for defines */ | 
| Peter Schneider-Kamp | 25f6894 | 2000-07-31 22:19:30 +0000 | [diff] [blame] | 5 |  | 
| Mark Dickinson | 835a6c8 | 2009-06-30 15:45:17 +0000 | [diff] [blame] | 6 | /* Some versions of HP-UX & Solaris need inttypes.h for int32_t, | 
 | 7 |    INT32_MAX, etc. */ | 
 | 8 | #ifdef HAVE_INTTYPES_H | 
 | 9 | #include <inttypes.h> | 
 | 10 | #endif | 
 | 11 |  | 
| Thomas Wouters | 89f507f | 2006-12-13 04:49:30 +0000 | [diff] [blame] | 12 | #ifdef HAVE_STDINT_H | 
 | 13 | #include <stdint.h> | 
 | 14 | #endif | 
 | 15 |  | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 16 | /************************************************************************** | 
 | 17 | Symbols and macros to supply platform-independent interfaces to basic | 
| Tim Peters | 1be4684 | 2000-07-23 18:10:18 +0000 | [diff] [blame] | 18 | C language & library operations whose spellings vary across platforms. | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 19 |  | 
 | 20 | Please try to make documentation here as clear as possible:  by definition, | 
 | 21 | the stuff here is trying to illuminate C's darkest corners. | 
 | 22 |  | 
 | 23 | Config #defines referenced here: | 
 | 24 |  | 
 | 25 | SIGNED_RIGHT_SHIFT_ZERO_FILLS | 
 | 26 | Meaning:  To be defined iff i>>j does not extend the sign bit when i is a | 
 | 27 |           signed integral type and i < 0. | 
 | 28 | Used in:  Py_ARITHMETIC_RIGHT_SHIFT | 
| Tim Peters | 1be4684 | 2000-07-23 18:10:18 +0000 | [diff] [blame] | 29 |  | 
| Tim Peters | 8315ea5 | 2000-07-23 19:28:35 +0000 | [diff] [blame] | 30 | Py_DEBUG | 
 | 31 | Meaning:  Extra checks compiled in for debug mode. | 
 | 32 | Used in:  Py_SAFE_DOWNCAST | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 33 |  | 
 | 34 | HAVE_UINTPTR_T | 
 | 35 | Meaning:  The C9X type uintptr_t is supported by the compiler | 
 | 36 | Used in:  Py_uintptr_t | 
 | 37 |  | 
 | 38 | HAVE_LONG_LONG | 
 | 39 | Meaning:  The compiler supports the C type "long long" | 
| Martin v. Löwis | b9a0f91 | 2003-03-29 10:06:18 +0000 | [diff] [blame] | 40 | Used in:  PY_LONG_LONG | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 41 |  | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 42 | **************************************************************************/ | 
 | 43 |  | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 44 | /* typedefs for some C9X-defined synonyms for integral types. | 
 | 45 |  * | 
 | 46 |  * The names in Python are exactly the same as the C9X names, except with a | 
 | 47 |  * Py_ prefix.  Until C9X is universally implemented, this is the only way | 
 | 48 |  * to ensure that Python gets reliable names that don't conflict with names | 
 | 49 |  * in non-Python code that are playing their own tricks to define the C9X | 
 | 50 |  * names. | 
 | 51 |  * | 
 | 52 |  * NOTE: don't go nuts here!  Python has no use for *most* of the C9X | 
 | 53 |  * integral synonyms.  Only define the ones we actually need. | 
 | 54 |  */ | 
 | 55 |  | 
 | 56 | #ifdef HAVE_LONG_LONG | 
| Martin v. Löwis | b9a0f91 | 2003-03-29 10:06:18 +0000 | [diff] [blame] | 57 | #ifndef PY_LONG_LONG | 
 | 58 | #define PY_LONG_LONG long long | 
| Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 59 | #if defined(LLONG_MAX) | 
 | 60 | /* If LLONG_MAX is defined in limits.h, use that. */ | 
 | 61 | #define PY_LLONG_MIN LLONG_MIN | 
 | 62 | #define PY_LLONG_MAX LLONG_MAX | 
 | 63 | #define PY_ULLONG_MAX ULLONG_MAX | 
 | 64 | #elif defined(__LONG_LONG_MAX__) | 
| Mark Dickinson | 6646cd4 | 2010-11-20 10:43:10 +0000 | [diff] [blame] | 65 | /* Otherwise, if GCC has a builtin define, use that.  (Definition of | 
 | 66 |  * PY_LLONG_MIN assumes two's complement with no trap representation.) */ | 
| Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 67 | #define PY_LLONG_MAX __LONG_LONG_MAX__ | 
| Mark Dickinson | 6646cd4 | 2010-11-20 10:43:10 +0000 | [diff] [blame] | 68 | #define PY_LLONG_MIN (-PY_LLONG_MAX - 1) | 
 | 69 | #define PY_ULLONG_MAX (PY_LLONG_MAX * Py_ULL(2) + 1) | 
 | 70 | #elif defined(SIZEOF_LONG_LONG) | 
 | 71 | /* Otherwise compute from SIZEOF_LONG_LONG, assuming two's complement, no | 
 | 72 |    padding bits, and no trap representation.  Note: PY_ULLONG_MAX was | 
 | 73 |    previously #defined as (~0ULL) here; but that'll give the wrong value in a | 
 | 74 |    preprocessor expression on systems where long long != intmax_t. */ | 
 | 75 | #define PY_LLONG_MAX                                                    \ | 
 | 76 |     (1 + 2 * ((Py_LL(1) << (CHAR_BIT * SIZEOF_LONG_LONG - 2)) - 1)) | 
 | 77 | #define PY_LLONG_MIN (-PY_LLONG_MAX - 1) | 
 | 78 | #define PY_ULLONG_MAX (PY_LLONG_MAX * Py_ULL(2) + 1) | 
| Guido van Rossum | cd16bf6 | 2007-06-13 18:07:49 +0000 | [diff] [blame] | 79 | #endif /* LLONG_MAX */ | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 80 | #endif | 
 | 81 | #endif /* HAVE_LONG_LONG */ | 
 | 82 |  | 
| Mark Dickinson | bd79264 | 2009-03-18 20:06:12 +0000 | [diff] [blame] | 83 | /* a build with 30-bit digits for Python long integers needs an exact-width | 
 | 84 |  * 32-bit unsigned integer type to store those digits.  (We could just use | 
 | 85 |  * type 'unsigned long', but that would be wasteful on a system where longs | 
 | 86 |  * are 64-bits.)  On Unix systems, the autoconf macro AC_TYPE_UINT32_T defines | 
 | 87 |  * uint32_t to be such a type unless stdint.h or inttypes.h defines uint32_t. | 
 | 88 |  * However, it doesn't set HAVE_UINT32_T, so we do that here. | 
 | 89 |  */ | 
 | 90 | #if (defined UINT32_MAX || defined uint32_t) | 
 | 91 | #ifndef PY_UINT32_T | 
 | 92 | #define HAVE_UINT32_T 1 | 
 | 93 | #define PY_UINT32_T uint32_t | 
 | 94 | #endif | 
 | 95 | #endif | 
 | 96 |  | 
 | 97 | /* Macros for a 64-bit unsigned integer type; used for type 'twodigits' in the | 
 | 98 |  * long integer implementation, when 30-bit digits are enabled. | 
 | 99 |  */ | 
 | 100 | #if (defined UINT64_MAX || defined uint64_t) | 
 | 101 | #ifndef PY_UINT64_T | 
 | 102 | #define HAVE_UINT64_T 1 | 
 | 103 | #define PY_UINT64_T uint64_t | 
 | 104 | #endif | 
 | 105 | #endif | 
 | 106 |  | 
 | 107 | /* Signed variants of the above */ | 
 | 108 | #if (defined INT32_MAX || defined int32_t) | 
 | 109 | #ifndef PY_INT32_T | 
 | 110 | #define HAVE_INT32_T 1 | 
 | 111 | #define PY_INT32_T int32_t | 
 | 112 | #endif | 
 | 113 | #endif | 
 | 114 | #if (defined INT64_MAX || defined int64_t) | 
 | 115 | #ifndef PY_INT64_T | 
 | 116 | #define HAVE_INT64_T 1 | 
 | 117 | #define PY_INT64_T int64_t | 
 | 118 | #endif | 
 | 119 | #endif | 
 | 120 |  | 
 | 121 | /* If PYLONG_BITS_IN_DIGIT is not defined then we'll use 30-bit digits if all | 
 | 122 |    the necessary integer types are available, and we're on a 64-bit platform | 
 | 123 |    (as determined by SIZEOF_VOID_P); otherwise we use 15-bit digits. */ | 
 | 124 |  | 
 | 125 | #ifndef PYLONG_BITS_IN_DIGIT | 
 | 126 | #if (defined HAVE_UINT64_T && defined HAVE_INT64_T && \ | 
 | 127 |      defined HAVE_UINT32_T && defined HAVE_INT32_T && SIZEOF_VOID_P >= 8) | 
 | 128 | #define PYLONG_BITS_IN_DIGIT 30 | 
 | 129 | #else | 
 | 130 | #define PYLONG_BITS_IN_DIGIT 15 | 
 | 131 | #endif | 
 | 132 | #endif | 
 | 133 |  | 
| Gregory P. Smith | 63e6c32 | 2012-01-14 15:31:34 -0800 | [diff] [blame] | 134 | /* Prime multiplier used in string and various other hashes. */ | 
 | 135 | #define _PyHASH_MULTIPLIER 1000003  /* 0xf4243 */ | 
 | 136 |  | 
| Mark Dickinson | dc787d2 | 2010-05-23 13:33:13 +0000 | [diff] [blame] | 137 | /* Parameters used for the numeric hash implementation.  See notes for | 
 | 138 |    _PyHash_Double in Objects/object.c.  Numeric hashes are based on | 
 | 139 |    reduction modulo the prime 2**_PyHASH_BITS - 1. */ | 
 | 140 |  | 
| Benjamin Peterson | 8f67d08 | 2010-10-17 20:54:53 +0000 | [diff] [blame] | 141 | #if SIZEOF_VOID_P >= 8 | 
| Mark Dickinson | dc787d2 | 2010-05-23 13:33:13 +0000 | [diff] [blame] | 142 | #define _PyHASH_BITS 61 | 
 | 143 | #else | 
 | 144 | #define _PyHASH_BITS 31 | 
 | 145 | #endif | 
| Benjamin Peterson | 8035bc5 | 2010-10-23 16:20:50 +0000 | [diff] [blame] | 146 | #define _PyHASH_MODULUS (((size_t)1 << _PyHASH_BITS) - 1) | 
| Mark Dickinson | dc787d2 | 2010-05-23 13:33:13 +0000 | [diff] [blame] | 147 | #define _PyHASH_INF 314159 | 
 | 148 | #define _PyHASH_NAN 0 | 
| Gregory P. Smith | 63e6c32 | 2012-01-14 15:31:34 -0800 | [diff] [blame] | 149 | #define _PyHASH_IMAG _PyHASH_MULTIPLIER | 
| Mark Dickinson | dc787d2 | 2010-05-23 13:33:13 +0000 | [diff] [blame] | 150 |  | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 151 | /* uintptr_t is the C9X name for an unsigned integral type such that a | 
 | 152 |  * legitimate void* can be cast to uintptr_t and then back to void* again | 
| Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 153 |  * without loss of information.  Similarly for intptr_t, wrt a signed | 
 | 154 |  * integral type. | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 155 |  */ | 
 | 156 | #ifdef HAVE_UINTPTR_T | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 157 | typedef uintptr_t       Py_uintptr_t; | 
 | 158 | typedef intptr_t        Py_intptr_t; | 
| Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 159 |  | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 160 | #elif SIZEOF_VOID_P <= SIZEOF_INT | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 161 | typedef unsigned int    Py_uintptr_t; | 
 | 162 | typedef int             Py_intptr_t; | 
| Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 163 |  | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 164 | #elif SIZEOF_VOID_P <= SIZEOF_LONG | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 165 | typedef unsigned long   Py_uintptr_t; | 
 | 166 | typedef long            Py_intptr_t; | 
| Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 167 |  | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 168 | #elif defined(HAVE_LONG_LONG) && (SIZEOF_VOID_P <= SIZEOF_LONG_LONG) | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 169 | typedef unsigned PY_LONG_LONG   Py_uintptr_t; | 
 | 170 | typedef PY_LONG_LONG            Py_intptr_t; | 
| Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 171 |  | 
| Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 172 | #else | 
 | 173 | #   error "Python needs a typedef for Py_uintptr_t in pyport.h." | 
 | 174 | #endif /* HAVE_UINTPTR_T */ | 
 | 175 |  | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 176 | /* Py_ssize_t is a signed integral type such that sizeof(Py_ssize_t) == | 
 | 177 |  * sizeof(size_t).  C99 doesn't define such a thing directly (size_t is an | 
 | 178 |  * unsigned integral type).  See PEP 353 for details. | 
 | 179 |  */ | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 180 | #ifdef HAVE_SSIZE_T | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 181 | typedef ssize_t         Py_ssize_t; | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 182 | #elif SIZEOF_VOID_P == SIZEOF_SIZE_T | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 183 | typedef Py_intptr_t     Py_ssize_t; | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 184 | #else | 
 | 185 | #   error "Python needs a typedef for Py_ssize_t in pyport.h." | 
 | 186 | #endif | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 187 |  | 
| Benjamin Peterson | 8f67d08 | 2010-10-17 20:54:53 +0000 | [diff] [blame] | 188 | /* Py_hash_t is the same size as a pointer. */ | 
 | 189 | typedef Py_ssize_t Py_hash_t; | 
| Benjamin Peterson | 8035bc5 | 2010-10-23 16:20:50 +0000 | [diff] [blame] | 190 | /* Py_uhash_t is the unsigned equivalent needed to calculate numeric hash. */ | 
 | 191 | typedef size_t Py_uhash_t; | 
| Benjamin Peterson | 8f67d08 | 2010-10-17 20:54:53 +0000 | [diff] [blame] | 192 |  | 
| Amaury Forgeot d'Arc | 9c74b14 | 2008-06-18 00:47:36 +0000 | [diff] [blame] | 193 | /* Largest possible value of size_t. | 
 | 194 |    SIZE_MAX is part of C99, so it might be defined on some | 
 | 195 |    platforms. If it is not defined, (size_t)-1 is a portable | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 196 |    definition for C89, due to the way signed->unsigned | 
| Amaury Forgeot d'Arc | 9c74b14 | 2008-06-18 00:47:36 +0000 | [diff] [blame] | 197 |    conversion is defined. */ | 
 | 198 | #ifdef SIZE_MAX | 
 | 199 | #define PY_SIZE_MAX SIZE_MAX | 
 | 200 | #else | 
 | 201 | #define PY_SIZE_MAX ((size_t)-1) | 
 | 202 | #endif | 
 | 203 |  | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 204 | /* Largest positive value of type Py_ssize_t. */ | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 205 | #define PY_SSIZE_T_MAX ((Py_ssize_t)(((size_t)-1)>>1)) | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 206 | /* Smallest negative value of type Py_ssize_t. */ | 
 | 207 | #define PY_SSIZE_T_MIN (-PY_SSIZE_T_MAX-1) | 
 | 208 |  | 
| Christian Heimes | 400adb0 | 2008-02-01 08:12:03 +0000 | [diff] [blame] | 209 | #if SIZEOF_PID_T > SIZEOF_LONG | 
 | 210 | #   error "Python doesn't support sizeof(pid_t) > sizeof(long)" | 
 | 211 | #endif | 
 | 212 |  | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 213 | /* PY_FORMAT_SIZE_T is a platform-specific modifier for use in a printf | 
 | 214 |  * format to convert an argument with the width of a size_t or Py_ssize_t. | 
 | 215 |  * C99 introduced "z" for this purpose, but not all platforms support that; | 
 | 216 |  * e.g., MS compilers use "I" instead. | 
 | 217 |  * | 
 | 218 |  * These "high level" Python format functions interpret "z" correctly on | 
 | 219 |  * all platforms (Python interprets the format string itself, and does whatever | 
 | 220 |  * the platform C requires to convert a size_t/Py_ssize_t argument): | 
 | 221 |  * | 
| Christian Heimes | 72b710a | 2008-05-26 13:28:38 +0000 | [diff] [blame] | 222 |  *     PyBytes_FromFormat | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 223 |  *     PyErr_Format | 
| Christian Heimes | 72b710a | 2008-05-26 13:28:38 +0000 | [diff] [blame] | 224 |  *     PyBytes_FromFormatV | 
| Walter Dörwald | 7696ed7 | 2007-05-31 15:51:35 +0000 | [diff] [blame] | 225 |  *     PyUnicode_FromFormatV | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 226 |  * | 
 | 227 |  * Lower-level uses require that you interpolate the correct format modifier | 
 | 228 |  * yourself (e.g., calling printf, fprintf, sprintf, PyOS_snprintf); for | 
 | 229 |  * example, | 
 | 230 |  * | 
 | 231 |  *     Py_ssize_t index; | 
 | 232 |  *     fprintf(stderr, "index %" PY_FORMAT_SIZE_T "d sucks\n", index); | 
 | 233 |  * | 
 | 234 |  * That will expand to %ld, or %Id, or to something else correct for a | 
 | 235 |  * Py_ssize_t on the platform. | 
 | 236 |  */ | 
 | 237 | #ifndef PY_FORMAT_SIZE_T | 
| Thomas Wouters | 89f507f | 2006-12-13 04:49:30 +0000 | [diff] [blame] | 238 | #   if SIZEOF_SIZE_T == SIZEOF_INT && !defined(__APPLE__) | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 239 | #       define PY_FORMAT_SIZE_T "" | 
 | 240 | #   elif SIZEOF_SIZE_T == SIZEOF_LONG | 
 | 241 | #       define PY_FORMAT_SIZE_T "l" | 
 | 242 | #   elif defined(MS_WINDOWS) | 
 | 243 | #       define PY_FORMAT_SIZE_T "I" | 
 | 244 | #   else | 
 | 245 | #       error "This platform's pyconfig.h needs to define PY_FORMAT_SIZE_T" | 
 | 246 | #   endif | 
 | 247 | #endif | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 248 |  | 
| Mark Dickinson | 6ce4a9a | 2009-11-16 17:00:11 +0000 | [diff] [blame] | 249 | /* PY_FORMAT_LONG_LONG is analogous to PY_FORMAT_SIZE_T above, but for | 
 | 250 |  * the long long type instead of the size_t type.  It's only available | 
 | 251 |  * when HAVE_LONG_LONG is defined. The "high level" Python format | 
 | 252 |  * functions listed above will interpret "lld" or "llu" correctly on | 
 | 253 |  * all platforms. | 
 | 254 |  */ | 
 | 255 | #ifdef HAVE_LONG_LONG | 
 | 256 | #   ifndef PY_FORMAT_LONG_LONG | 
 | 257 | #       if defined(MS_WIN64) || defined(MS_WINDOWS) | 
 | 258 | #           define PY_FORMAT_LONG_LONG "I64" | 
 | 259 | #       else | 
 | 260 | #           error "This platform's pyconfig.h needs to define PY_FORMAT_LONG_LONG" | 
 | 261 | #       endif | 
 | 262 | #   endif | 
 | 263 | #endif | 
 | 264 |  | 
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 265 | /* Py_LOCAL can be used instead of static to get the fastest possible calling | 
 | 266 |  * convention for functions that are local to a given module. | 
 | 267 |  * | 
 | 268 |  * Py_LOCAL_INLINE does the same thing, and also explicitly requests inlining, | 
 | 269 |  * for platforms that support that. | 
 | 270 |  * | 
 | 271 |  * If PY_LOCAL_AGGRESSIVE is defined before python.h is included, more | 
 | 272 |  * "aggressive" inlining/optimizaion is enabled for the entire module.  This | 
 | 273 |  * may lead to code bloat, and may slow things down for those reasons.  It may | 
 | 274 |  * also lead to errors, if the code relies on pointer aliasing.  Use with | 
 | 275 |  * care. | 
 | 276 |  * | 
 | 277 |  * NOTE: You can only use this for functions that are entirely local to a | 
 | 278 |  * module; functions that are exported via method tables, callbacks, etc, | 
 | 279 |  * should keep using static. | 
 | 280 |  */ | 
 | 281 |  | 
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 282 | #if defined(_MSC_VER) | 
 | 283 | #if defined(PY_LOCAL_AGGRESSIVE) | 
 | 284 | /* enable more aggressive optimization for visual studio */ | 
 | 285 | #pragma optimize("agtw", on) | 
 | 286 | #endif | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 287 | /* ignore warnings if the compiler decides not to inline a function */ | 
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 288 | #pragma warning(disable: 4710) | 
 | 289 | /* fastest possible local call under MSVC */ | 
 | 290 | #define Py_LOCAL(type) static type __fastcall | 
 | 291 | #define Py_LOCAL_INLINE(type) static __inline type __fastcall | 
 | 292 | #elif defined(USE_INLINE) | 
 | 293 | #define Py_LOCAL(type) static type | 
 | 294 | #define Py_LOCAL_INLINE(type) static inline type | 
 | 295 | #else | 
 | 296 | #define Py_LOCAL(type) static type | 
 | 297 | #define Py_LOCAL_INLINE(type) static type | 
 | 298 | #endif | 
 | 299 |  | 
| Thomas Wouters | 4d70c3d | 2006-06-08 14:42:34 +0000 | [diff] [blame] | 300 | /* Py_MEMCPY can be used instead of memcpy in cases where the copied blocks | 
 | 301 |  * are often very short.  While most platforms have highly optimized code for | 
 | 302 |  * large transfers, the setup costs for memcpy are often quite high.  MEMCPY | 
 | 303 |  * solves this by doing short copies "in line". | 
 | 304 |  */ | 
 | 305 |  | 
 | 306 | #if defined(_MSC_VER) | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 307 | #define Py_MEMCPY(target, source, length) do {                          \ | 
 | 308 |         size_t i_, n_ = (length);                                       \ | 
 | 309 |         char *t_ = (void*) (target);                                    \ | 
 | 310 |         const char *s_ = (void*) (source);                              \ | 
 | 311 |         if (n_ >= 16)                                                   \ | 
 | 312 |             memcpy(t_, s_, n_);                                         \ | 
 | 313 |         else                                                            \ | 
 | 314 |             for (i_ = 0; i_ < n_; i_++)                                 \ | 
 | 315 |                 t_[i_] = s_[i_];                                        \ | 
 | 316 |     } while (0) | 
| Thomas Wouters | 4d70c3d | 2006-06-08 14:42:34 +0000 | [diff] [blame] | 317 | #else | 
 | 318 | #define Py_MEMCPY memcpy | 
 | 319 | #endif | 
 | 320 |  | 
| Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 321 | #include <stdlib.h> | 
| Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 322 |  | 
| Mark Dickinson | a4962cb | 2009-11-28 12:35:42 +0000 | [diff] [blame] | 323 | #ifdef HAVE_IEEEFP_H | 
 | 324 | #include <ieeefp.h>  /* needed for 'finite' declaration on some platforms */ | 
 | 325 | #endif | 
 | 326 |  | 
| Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 327 | #include <math.h> /* Moved here from the math section, before extern "C" */ | 
 | 328 |  | 
 | 329 | /******************************************** | 
 | 330 |  * WRAPPER FOR <time.h> and/or <sys/time.h> * | 
 | 331 |  ********************************************/ | 
 | 332 |  | 
 | 333 | #ifdef TIME_WITH_SYS_TIME | 
 | 334 | #include <sys/time.h> | 
 | 335 | #include <time.h> | 
 | 336 | #else /* !TIME_WITH_SYS_TIME */ | 
 | 337 | #ifdef HAVE_SYS_TIME_H | 
 | 338 | #include <sys/time.h> | 
 | 339 | #else /* !HAVE_SYS_TIME_H */ | 
 | 340 | #include <time.h> | 
 | 341 | #endif /* !HAVE_SYS_TIME_H */ | 
 | 342 | #endif /* !TIME_WITH_SYS_TIME */ | 
 | 343 |  | 
 | 344 |  | 
 | 345 | /****************************** | 
 | 346 |  * WRAPPER FOR <sys/select.h> * | 
 | 347 |  ******************************/ | 
 | 348 |  | 
 | 349 | /* NB caller must include <sys/types.h> */ | 
 | 350 |  | 
 | 351 | #ifdef HAVE_SYS_SELECT_H | 
| Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 352 | #include <sys/select.h> | 
| Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 353 | #endif /* !HAVE_SYS_SELECT_H */ | 
 | 354 |  | 
| Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 355 | /******************************* | 
 | 356 |  * stat() and fstat() fiddling * | 
 | 357 |  *******************************/ | 
 | 358 |  | 
 | 359 | /* We expect that stat and fstat exist on most systems. | 
 | 360 |  *  It's confirmed on Unix, Mac and Windows. | 
 | 361 |  *  If you don't have them, add | 
 | 362 |  *      #define DONT_HAVE_STAT | 
 | 363 |  * and/or | 
 | 364 |  *      #define DONT_HAVE_FSTAT | 
| Tim Peters | 76f373d | 2001-07-26 21:34:59 +0000 | [diff] [blame] | 365 |  * to your pyconfig.h. Python code beyond this should check HAVE_STAT and | 
| Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 366 |  * HAVE_FSTAT instead. | 
 | 367 |  * Also | 
| Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 368 |  *      #define HAVE_SYS_STAT_H | 
 | 369 |  * if <sys/stat.h> exists on your platform, and | 
| Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 370 |  *      #define HAVE_STAT_H | 
| Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 371 |  * if <stat.h> does. | 
| Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 372 |  */ | 
 | 373 | #ifndef DONT_HAVE_STAT | 
 | 374 | #define HAVE_STAT | 
 | 375 | #endif | 
 | 376 |  | 
 | 377 | #ifndef DONT_HAVE_FSTAT | 
 | 378 | #define HAVE_FSTAT | 
 | 379 | #endif | 
 | 380 |  | 
| Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 381 | #ifdef HAVE_SYS_STAT_H | 
| Andrew MacIntyre | 5e090fc | 2002-02-26 11:20:01 +0000 | [diff] [blame] | 382 | #if defined(PYOS_OS2) && defined(PYCC_GCC) | 
 | 383 | #include <sys/types.h> | 
 | 384 | #endif | 
| Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 385 | #include <sys/stat.h> | 
 | 386 | #elif defined(HAVE_STAT_H) | 
 | 387 | #include <stat.h> | 
 | 388 | #endif | 
 | 389 |  | 
| Martin v. Löwis | f9836ba | 2001-08-08 10:28:06 +0000 | [diff] [blame] | 390 | #if defined(PYCC_VACPP) | 
 | 391 | /* VisualAge C/C++ Failed to Define MountType Field in sys/stat.h */ | 
 | 392 | #define S_IFMT (S_IFDIR|S_IFCHR|S_IFREG) | 
 | 393 | #endif | 
 | 394 |  | 
 | 395 | #ifndef S_ISREG | 
 | 396 | #define S_ISREG(x) (((x) & S_IFMT) == S_IFREG) | 
 | 397 | #endif | 
 | 398 |  | 
 | 399 | #ifndef S_ISDIR | 
 | 400 | #define S_ISDIR(x) (((x) & S_IFMT) == S_IFDIR) | 
 | 401 | #endif | 
 | 402 |  | 
| Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 403 |  | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 404 | #ifdef __cplusplus | 
| Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 405 | /* Move this down here since some C++ #include's don't like to be included | 
 | 406 |    inside an extern "C" */ | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 407 | extern "C" { | 
 | 408 | #endif | 
 | 409 |  | 
| Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 410 |  | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 411 | /* Py_ARITHMETIC_RIGHT_SHIFT | 
 | 412 |  * C doesn't define whether a right-shift of a signed integer sign-extends | 
 | 413 |  * or zero-fills.  Here a macro to force sign extension: | 
 | 414 |  * Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) | 
| Mark Dickinson | 16f966e | 2009-03-20 23:23:15 +0000 | [diff] [blame] | 415 |  *    Return I >> J, forcing sign extension.  Arithmetically, return the | 
 | 416 |  *    floor of I/2**J. | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 417 |  * Requirements: | 
| Mark Dickinson | 16f966e | 2009-03-20 23:23:15 +0000 | [diff] [blame] | 418 |  *    I should have signed integer type.  In the terminology of C99, this can | 
 | 419 |  *    be either one of the five standard signed integer types (signed char, | 
 | 420 |  *    short, int, long, long long) or an extended signed integer type. | 
 | 421 |  *    J is an integer >= 0 and strictly less than the number of bits in the | 
 | 422 |  *    type of I (because C doesn't define what happens for J outside that | 
 | 423 |  *    range either). | 
 | 424 |  *    TYPE used to specify the type of I, but is now ignored.  It's been left | 
 | 425 |  *    in for backwards compatibility with versions <= 2.6 or 3.0. | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 426 |  * Caution: | 
 | 427 |  *    I may be evaluated more than once. | 
 | 428 |  */ | 
 | 429 | #ifdef SIGNED_RIGHT_SHIFT_ZERO_FILLS | 
 | 430 | #define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) \ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 431 |     ((I) < 0 ? -1-((-1-(I)) >> (J)) : (I) >> (J)) | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 432 | #else | 
 | 433 | #define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) ((I) >> (J)) | 
 | 434 | #endif | 
 | 435 |  | 
| Tim Peters | 39dce29 | 2000-08-15 03:34:48 +0000 | [diff] [blame] | 436 | /* Py_FORCE_EXPANSION(X) | 
| Tim Peters | 1be4684 | 2000-07-23 18:10:18 +0000 | [diff] [blame] | 437 |  * "Simply" returns its argument.  However, macro expansions within the | 
 | 438 |  * argument are evaluated.  This unfortunate trickery is needed to get | 
 | 439 |  * token-pasting to work as desired in some cases. | 
 | 440 |  */ | 
 | 441 | #define Py_FORCE_EXPANSION(X) X | 
 | 442 |  | 
| Tim Peters | 8315ea5 | 2000-07-23 19:28:35 +0000 | [diff] [blame] | 443 | /* Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) | 
 | 444 |  * Cast VALUE to type NARROW from type WIDE.  In Py_DEBUG mode, this | 
 | 445 |  * assert-fails if any information is lost. | 
 | 446 |  * Caution: | 
 | 447 |  *    VALUE may be evaluated more than once. | 
 | 448 |  */ | 
 | 449 | #ifdef Py_DEBUG | 
 | 450 | #define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) \ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 451 |     (assert((WIDE)(NARROW)(VALUE) == (VALUE)), (NARROW)(VALUE)) | 
| Tim Peters | 8315ea5 | 2000-07-23 19:28:35 +0000 | [diff] [blame] | 452 | #else | 
 | 453 | #define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) (NARROW)(VALUE) | 
 | 454 | #endif | 
 | 455 |  | 
| Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 456 | /* Py_SET_ERRNO_ON_MATH_ERROR(x) | 
| Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 457 |  * If a libm function did not set errno, but it looks like the result | 
| Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 458 |  * overflowed or not-a-number, set errno to ERANGE or EDOM.  Set errno | 
 | 459 |  * to 0 before calling a libm function, and invoke this macro after, | 
 | 460 |  * passing the function result. | 
| Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 461 |  * Caution: | 
 | 462 |  *    This isn't reliable.  See Py_OVERFLOWED comments. | 
 | 463 |  *    X is evaluated more than once. | 
 | 464 |  */ | 
| Guido van Rossum | 539c662 | 2005-09-14 17:49:54 +0000 | [diff] [blame] | 465 | #if defined(__FreeBSD__) || defined(__OpenBSD__) || (defined(__hpux) && defined(__ia64)) | 
| Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 466 | #define _Py_SET_EDOM_FOR_NAN(X) if (isnan(X)) errno = EDOM; | 
 | 467 | #else | 
 | 468 | #define _Py_SET_EDOM_FOR_NAN(X) ; | 
 | 469 | #endif | 
 | 470 | #define Py_SET_ERRNO_ON_MATH_ERROR(X) \ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 471 |     do { \ | 
 | 472 |         if (errno == 0) { \ | 
 | 473 |             if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL) \ | 
 | 474 |                 errno = ERANGE; \ | 
 | 475 |             else _Py_SET_EDOM_FOR_NAN(X) \ | 
 | 476 |         } \ | 
 | 477 |     } while(0) | 
| Tim Peters | 57f282a | 2001-09-05 05:38:10 +0000 | [diff] [blame] | 478 |  | 
| Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 479 | /* Py_SET_ERANGE_ON_OVERFLOW(x) | 
 | 480 |  * An alias of Py_SET_ERRNO_ON_MATH_ERROR for backward-compatibility. | 
 | 481 |  */ | 
 | 482 | #define Py_SET_ERANGE_IF_OVERFLOW(X) Py_SET_ERRNO_ON_MATH_ERROR(X) | 
 | 483 |  | 
| Tim Peters | dc5a508 | 2002-03-09 04:58:24 +0000 | [diff] [blame] | 484 | /* Py_ADJUST_ERANGE1(x) | 
 | 485 |  * Py_ADJUST_ERANGE2(x, y) | 
 | 486 |  * Set errno to 0 before calling a libm function, and invoke one of these | 
 | 487 |  * macros after, passing the function result(s) (Py_ADJUST_ERANGE2 is useful | 
 | 488 |  * for functions returning complex results).  This makes two kinds of | 
 | 489 |  * adjustments to errno:  (A) If it looks like the platform libm set | 
 | 490 |  * errno=ERANGE due to underflow, clear errno. (B) If it looks like the | 
 | 491 |  * platform libm overflowed but didn't set errno, force errno to ERANGE.  In | 
 | 492 |  * effect, we're trying to force a useful implementation of C89 errno | 
 | 493 |  * behavior. | 
 | 494 |  * Caution: | 
 | 495 |  *    This isn't reliable.  See Py_OVERFLOWED comments. | 
 | 496 |  *    X and Y may be evaluated more than once. | 
 | 497 |  */ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 498 | #define Py_ADJUST_ERANGE1(X)                                            \ | 
 | 499 |     do {                                                                \ | 
 | 500 |         if (errno == 0) {                                               \ | 
 | 501 |             if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL)              \ | 
 | 502 |                 errno = ERANGE;                                         \ | 
 | 503 |         }                                                               \ | 
 | 504 |         else if (errno == ERANGE && (X) == 0.0)                         \ | 
 | 505 |             errno = 0;                                                  \ | 
 | 506 |     } while(0) | 
| Tim Peters | dc5a508 | 2002-03-09 04:58:24 +0000 | [diff] [blame] | 507 |  | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 508 | #define Py_ADJUST_ERANGE2(X, Y)                                         \ | 
 | 509 |     do {                                                                \ | 
 | 510 |         if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL ||                \ | 
 | 511 |             (Y) == Py_HUGE_VAL || (Y) == -Py_HUGE_VAL) {                \ | 
 | 512 |                         if (errno == 0)                                 \ | 
 | 513 |                                 errno = ERANGE;                         \ | 
 | 514 |         }                                                               \ | 
 | 515 |         else if (errno == ERANGE)                                       \ | 
 | 516 |             errno = 0;                                                  \ | 
 | 517 |     } while(0) | 
| Tim Peters | dc5a508 | 2002-03-09 04:58:24 +0000 | [diff] [blame] | 518 |  | 
| Mark Dickinson | a4262b9 | 2009-04-19 11:35:55 +0000 | [diff] [blame] | 519 | /*  The functions _Py_dg_strtod and _Py_dg_dtoa in Python/dtoa.c (which are | 
 | 520 |  *  required to support the short float repr introduced in Python 3.1) require | 
 | 521 |  *  that the floating-point unit that's being used for arithmetic operations | 
 | 522 |  *  on C doubles is set to use 53-bit precision.  It also requires that the | 
 | 523 |  *  FPU rounding mode is round-half-to-even, but that's less often an issue. | 
 | 524 |  * | 
 | 525 |  *  If your FPU isn't already set to 53-bit precision/round-half-to-even, and | 
 | 526 |  *  you want to make use of _Py_dg_strtod and _Py_dg_dtoa, then you should | 
 | 527 |  * | 
 | 528 |  *     #define HAVE_PY_SET_53BIT_PRECISION 1 | 
 | 529 |  * | 
 | 530 |  *  and also give appropriate definitions for the following three macros: | 
 | 531 |  * | 
 | 532 |  *    _PY_SET_53BIT_PRECISION_START : store original FPU settings, and | 
 | 533 |  *        set FPU to 53-bit precision/round-half-to-even | 
 | 534 |  *    _PY_SET_53BIT_PRECISION_END : restore original FPU settings | 
 | 535 |  *    _PY_SET_53BIT_PRECISION_HEADER : any variable declarations needed to | 
 | 536 |  *        use the two macros above. | 
 | 537 |  * | 
 | 538 |  * The macros are designed to be used within a single C function: see | 
 | 539 |  * Python/pystrtod.c for an example of their use. | 
 | 540 |  */ | 
| Mark Dickinson | b08a53a | 2009-04-16 19:52:09 +0000 | [diff] [blame] | 541 |  | 
| Mark Dickinson | a4262b9 | 2009-04-19 11:35:55 +0000 | [diff] [blame] | 542 | /* get and set x87 control word for gcc/x86 */ | 
| Mark Dickinson | 7abf8d4 | 2009-04-18 20:17:52 +0000 | [diff] [blame] | 543 | #ifdef HAVE_GCC_ASM_FOR_X87 | 
| Mark Dickinson | a4262b9 | 2009-04-19 11:35:55 +0000 | [diff] [blame] | 544 | #define HAVE_PY_SET_53BIT_PRECISION 1 | 
 | 545 | /* _Py_get/set_387controlword functions are defined in Python/pymath.c */ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 546 | #define _Py_SET_53BIT_PRECISION_HEADER                          \ | 
 | 547 |     unsigned short old_387controlword, new_387controlword | 
 | 548 | #define _Py_SET_53BIT_PRECISION_START                                   \ | 
 | 549 |     do {                                                                \ | 
 | 550 |         old_387controlword = _Py_get_387controlword();                  \ | 
 | 551 |         new_387controlword = (old_387controlword & ~0x0f00) | 0x0200; \ | 
 | 552 |         if (new_387controlword != old_387controlword)                   \ | 
 | 553 |             _Py_set_387controlword(new_387controlword);                 \ | 
 | 554 |     } while (0) | 
 | 555 | #define _Py_SET_53BIT_PRECISION_END                             \ | 
 | 556 |     if (new_387controlword != old_387controlword)               \ | 
 | 557 |         _Py_set_387controlword(old_387controlword) | 
| Mark Dickinson | a4262b9 | 2009-04-19 11:35:55 +0000 | [diff] [blame] | 558 | #endif | 
 | 559 |  | 
| Mark Dickinson | 18e3d81 | 2012-04-15 15:10:56 +0100 | [diff] [blame] | 560 | /* get and set x87 control word for VisualStudio/x86 */ | 
 | 561 | #if defined(_MSC_VER) && !defined(_WIN64) /* x87 not supported in 64-bit */ | 
 | 562 | #define HAVE_PY_SET_53BIT_PRECISION 1 | 
 | 563 | #define _Py_SET_53BIT_PRECISION_HEADER \ | 
 | 564 |     unsigned int old_387controlword, new_387controlword, out_387controlword | 
 | 565 | /* We use the __control87_2 function to set only the x87 control word. | 
 | 566 |    The SSE control word is unaffected. */ | 
 | 567 | #define _Py_SET_53BIT_PRECISION_START                                   \ | 
 | 568 |     do {                                                                \ | 
 | 569 |         __control87_2(0, 0, &old_387controlword, NULL);                 \ | 
 | 570 |         new_387controlword =                                            \ | 
 | 571 |           (old_387controlword & ~(_MCW_PC | _MCW_RC)) | (_PC_53 | _RC_NEAR); \ | 
 | 572 |         if (new_387controlword != old_387controlword)                   \ | 
 | 573 |             __control87_2(new_387controlword, _MCW_PC | _MCW_RC,        \ | 
 | 574 |                           &out_387controlword, NULL);                   \ | 
 | 575 |     } while (0) | 
 | 576 | #define _Py_SET_53BIT_PRECISION_END                                     \ | 
 | 577 |     do {                                                                \ | 
 | 578 |         if (new_387controlword != old_387controlword)                   \ | 
 | 579 |             __control87_2(old_387controlword, _MCW_PC | _MCW_RC,        \ | 
 | 580 |                           &out_387controlword, NULL);                   \ | 
 | 581 |     } while (0) | 
 | 582 | #endif | 
 | 583 |  | 
| Mark Dickinson | a4262b9 | 2009-04-19 11:35:55 +0000 | [diff] [blame] | 584 | /* default definitions are empty */ | 
 | 585 | #ifndef HAVE_PY_SET_53BIT_PRECISION | 
| Mark Dickinson | b08a53a | 2009-04-16 19:52:09 +0000 | [diff] [blame] | 586 | #define _Py_SET_53BIT_PRECISION_HEADER | 
 | 587 | #define _Py_SET_53BIT_PRECISION_START | 
 | 588 | #define _Py_SET_53BIT_PRECISION_END | 
 | 589 | #endif | 
 | 590 |  | 
 | 591 | /* If we can't guarantee 53-bit precision, don't use the code | 
 | 592 |    in Python/dtoa.c, but fall back to standard code.  This | 
 | 593 |    means that repr of a float will be long (17 sig digits). | 
 | 594 |  | 
 | 595 |    Realistically, there are two things that could go wrong: | 
 | 596 |  | 
 | 597 |    (1) doubles aren't IEEE 754 doubles, or | 
 | 598 |    (2) we're on x86 with the rounding precision set to 64-bits | 
 | 599 |        (extended precision), and we don't know how to change | 
 | 600 |        the rounding precision. | 
 | 601 |  */ | 
 | 602 |  | 
 | 603 | #if !defined(DOUBLE_IS_LITTLE_ENDIAN_IEEE754) && \ | 
 | 604 |     !defined(DOUBLE_IS_BIG_ENDIAN_IEEE754) && \ | 
 | 605 |     !defined(DOUBLE_IS_ARM_MIXED_ENDIAN_IEEE754) | 
 | 606 | #define PY_NO_SHORT_FLOAT_REPR | 
 | 607 | #endif | 
 | 608 |  | 
| Mark Dickinson | 60fd099 | 2009-04-18 10:16:35 +0000 | [diff] [blame] | 609 | /* double rounding is symptomatic of use of extended precision on x86.  If | 
 | 610 |    we're seeing double rounding, and we don't have any mechanism available for | 
 | 611 |    changing the FPU rounding precision, then don't use Python/dtoa.c. */ | 
| Mark Dickinson | a4262b9 | 2009-04-19 11:35:55 +0000 | [diff] [blame] | 612 | #if defined(X87_DOUBLE_ROUNDING) && !defined(HAVE_PY_SET_53BIT_PRECISION) | 
| Mark Dickinson | b08a53a | 2009-04-16 19:52:09 +0000 | [diff] [blame] | 613 | #define PY_NO_SHORT_FLOAT_REPR | 
 | 614 | #endif | 
 | 615 |  | 
 | 616 |  | 
| Neal Norwitz | 8029264 | 2002-12-19 15:12:26 +0000 | [diff] [blame] | 617 | /* Py_DEPRECATED(version) | 
| Neal Norwitz | 93344ab | 2002-12-19 15:24:11 +0000 | [diff] [blame] | 618 |  * Declare a variable, type, or function deprecated. | 
| Neal Norwitz | 8029264 | 2002-12-19 15:12:26 +0000 | [diff] [blame] | 619 |  * Usage: | 
 | 620 |  *    extern int old_var Py_DEPRECATED(2.3); | 
 | 621 |  *    typedef int T1 Py_DEPRECATED(2.4); | 
 | 622 |  *    extern int x() Py_DEPRECATED(2.5); | 
 | 623 |  */ | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 624 | #if defined(__GNUC__) && ((__GNUC__ >= 4) || \ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 625 |               (__GNUC__ == 3) && (__GNUC_MINOR__ >= 1)) | 
| Neal Norwitz | 8029264 | 2002-12-19 15:12:26 +0000 | [diff] [blame] | 626 | #define Py_DEPRECATED(VERSION_UNUSED) __attribute__((__deprecated__)) | 
 | 627 | #else | 
| Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 628 | #define Py_DEPRECATED(VERSION_UNUSED) | 
| Neal Norwitz | 8029264 | 2002-12-19 15:12:26 +0000 | [diff] [blame] | 629 | #endif | 
 | 630 |  | 
| Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 631 | /************************************************************************** | 
 | 632 | Prototypes that are missing from the standard include files on some systems | 
 | 633 | (and possibly only some versions of such systems.) | 
 | 634 |  | 
 | 635 | Please be conservative with adding new ones, document them and enclose them | 
 | 636 | in platform-specific #ifdefs. | 
 | 637 | **************************************************************************/ | 
 | 638 |  | 
 | 639 | #ifdef SOLARIS | 
 | 640 | /* Unchecked */ | 
 | 641 | extern int gethostname(char *, int); | 
 | 642 | #endif | 
 | 643 |  | 
| Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 644 | #ifdef HAVE__GETPTY | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 645 | #include <sys/types.h>          /* we need to import mode_t */ | 
| Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 646 | extern char * _getpty(int *, int, mode_t, int); | 
 | 647 | #endif | 
 | 648 |  | 
| Georg Brandl | f78e02b | 2008-06-10 17:40:04 +0000 | [diff] [blame] | 649 | /* On QNX 6, struct termio must be declared by including sys/termio.h | 
 | 650 |    if TCGETA, TCSETA, TCSETAW, or TCSETAF are used.  sys/termio.h must | 
 | 651 |    be included before termios.h or it will generate an error. */ | 
 | 652 | #ifdef HAVE_SYS_TERMIO_H | 
 | 653 | #include <sys/termio.h> | 
 | 654 | #endif | 
 | 655 |  | 
| Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 656 | #if defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) | 
 | 657 | #if !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H) | 
 | 658 | /* BSDI does not supply a prototype for the 'openpty' and 'forkpty' | 
 | 659 |    functions, even though they are included in libutil. */ | 
 | 660 | #include <termios.h> | 
 | 661 | extern int openpty(int *, int *, char *, struct termios *, struct winsize *); | 
| Christian Heimes | 400adb0 | 2008-02-01 08:12:03 +0000 | [diff] [blame] | 662 | extern pid_t forkpty(int *, char *, struct termios *, struct winsize *); | 
| Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 663 | #endif /* !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H) */ | 
 | 664 | #endif /* defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) */ | 
 | 665 |  | 
 | 666 |  | 
| Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 667 | /* On 4.4BSD-descendants, ctype functions serves the whole range of | 
 | 668 |  * wchar_t character set rather than single byte code points only. | 
 | 669 |  * This characteristic can break some operations of string object | 
 | 670 |  * including str.upper() and str.split() on UTF-8 locales.  This | 
 | 671 |  * workaround was provided by Tim Robbins of FreeBSD project. | 
 | 672 |  */ | 
| Hye-Shik Chang | b5047fd | 2004-08-04 06:33:51 +0000 | [diff] [blame] | 673 |  | 
 | 674 | #ifdef __FreeBSD__ | 
 | 675 | #include <osreldate.h> | 
 | 676 | #if __FreeBSD_version > 500039 | 
| Ronald Oussoren | 501aeff | 2010-04-18 15:02:38 +0000 | [diff] [blame] | 677 | # define _PY_PORT_CTYPE_UTF8_ISSUE | 
 | 678 | #endif | 
 | 679 | #endif | 
 | 680 |  | 
 | 681 |  | 
 | 682 | #if defined(__APPLE__) | 
 | 683 | # define _PY_PORT_CTYPE_UTF8_ISSUE | 
 | 684 | #endif | 
 | 685 |  | 
 | 686 | #ifdef _PY_PORT_CTYPE_UTF8_ISSUE | 
| Hye-Shik Chang | b5047fd | 2004-08-04 06:33:51 +0000 | [diff] [blame] | 687 | #include <ctype.h> | 
 | 688 | #include <wctype.h> | 
 | 689 | #undef isalnum | 
 | 690 | #define isalnum(c) iswalnum(btowc(c)) | 
 | 691 | #undef isalpha | 
 | 692 | #define isalpha(c) iswalpha(btowc(c)) | 
 | 693 | #undef islower | 
 | 694 | #define islower(c) iswlower(btowc(c)) | 
 | 695 | #undef isspace | 
 | 696 | #define isspace(c) iswspace(btowc(c)) | 
 | 697 | #undef isupper | 
 | 698 | #define isupper(c) iswupper(btowc(c)) | 
 | 699 | #undef tolower | 
 | 700 | #define tolower(c) towlower(btowc(c)) | 
 | 701 | #undef toupper | 
 | 702 | #define toupper(c) towupper(btowc(c)) | 
 | 703 | #endif | 
| Hye-Shik Chang | b5047fd | 2004-08-04 06:33:51 +0000 | [diff] [blame] | 704 |  | 
 | 705 |  | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 706 | /* Declarations for symbol visibility. | 
 | 707 |  | 
 | 708 |   PyAPI_FUNC(type): Declares a public Python API function and return type | 
| Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 709 |   PyAPI_DATA(type): Declares public Python data and its type | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 710 |   PyMODINIT_FUNC:   A Python module init function.  If these functions are | 
| Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 711 |                     inside the Python core, they are private to the core. | 
 | 712 |                     If in an extension module, it may be declared with | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 713 |                     external linkage depending on the platform. | 
 | 714 |  | 
 | 715 |   As a number of platforms support/require "__declspec(dllimport/dllexport)", | 
 | 716 |   we support a HAVE_DECLSPEC_DLL macro to save duplication. | 
 | 717 | */ | 
 | 718 |  | 
| Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 719 | /* | 
| Michael W. Hudson | f163d10 | 2003-02-10 19:36:46 +0000 | [diff] [blame] | 720 |   All windows ports, except cygwin, are handled in PC/pyconfig.h. | 
 | 721 |  | 
| Skip Montanaro | eb33e5a | 2007-08-17 12:57:41 +0000 | [diff] [blame] | 722 |   Cygwin is the only other autoconf platform requiring special | 
 | 723 |   linkage handling and it uses __declspec(). | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 724 | */ | 
| Skip Montanaro | eb33e5a | 2007-08-17 12:57:41 +0000 | [diff] [blame] | 725 | #if defined(__CYGWIN__) | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 726 | #       define HAVE_DECLSPEC_DLL | 
| Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 727 | #endif | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 728 |  | 
| Jason Tishler | 3076559 | 2003-09-04 11:04:06 +0000 | [diff] [blame] | 729 | /* only get special linkage if built as shared or platform is Cygwin */ | 
 | 730 | #if defined(Py_ENABLE_SHARED) || defined(__CYGWIN__) | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 731 | #       if defined(HAVE_DECLSPEC_DLL) | 
 | 732 | #               ifdef Py_BUILD_CORE | 
 | 733 | #                       define PyAPI_FUNC(RTYPE) __declspec(dllexport) RTYPE | 
 | 734 | #                       define PyAPI_DATA(RTYPE) extern __declspec(dllexport) RTYPE | 
| Daniel Stutzbach | 3861599 | 2010-09-14 16:02:01 +0000 | [diff] [blame] | 735 |         /* module init functions inside the core need no external linkage */ | 
 | 736 |         /* except for Cygwin to handle embedding */ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 737 | #                       if defined(__CYGWIN__) | 
 | 738 | #                               define PyMODINIT_FUNC __declspec(dllexport) PyObject* | 
 | 739 | #                       else /* __CYGWIN__ */ | 
 | 740 | #                               define PyMODINIT_FUNC PyObject* | 
 | 741 | #                       endif /* __CYGWIN__ */ | 
 | 742 | #               else /* Py_BUILD_CORE */ | 
| Daniel Stutzbach | 3861599 | 2010-09-14 16:02:01 +0000 | [diff] [blame] | 743 |         /* Building an extension module, or an embedded situation */ | 
 | 744 |         /* public Python functions and data are imported */ | 
 | 745 |         /* Under Cygwin, auto-import functions to prevent compilation */ | 
 | 746 |         /* failures similar to those described at the bottom of 4.1: */ | 
 | 747 |         /* http://docs.python.org/extending/windows.html#a-cookbook-approach */ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 748 | #                       if !defined(__CYGWIN__) | 
 | 749 | #                               define PyAPI_FUNC(RTYPE) __declspec(dllimport) RTYPE | 
 | 750 | #                       endif /* !__CYGWIN__ */ | 
 | 751 | #                       define PyAPI_DATA(RTYPE) extern __declspec(dllimport) RTYPE | 
| Daniel Stutzbach | 3861599 | 2010-09-14 16:02:01 +0000 | [diff] [blame] | 752 |         /* module init functions outside the core must be exported */ | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 753 | #                       if defined(__cplusplus) | 
 | 754 | #                               define PyMODINIT_FUNC extern "C" __declspec(dllexport) PyObject* | 
 | 755 | #                       else /* __cplusplus */ | 
 | 756 | #                               define PyMODINIT_FUNC __declspec(dllexport) PyObject* | 
 | 757 | #                       endif /* __cplusplus */ | 
 | 758 | #               endif /* Py_BUILD_CORE */ | 
 | 759 | #       endif /* HAVE_DECLSPEC */ | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 760 | #endif /* Py_ENABLE_SHARED */ | 
 | 761 |  | 
 | 762 | /* If no external linkage macros defined by now, create defaults */ | 
 | 763 | #ifndef PyAPI_FUNC | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 764 | #       define PyAPI_FUNC(RTYPE) RTYPE | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 765 | #endif | 
 | 766 | #ifndef PyAPI_DATA | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 767 | #       define PyAPI_DATA(RTYPE) extern RTYPE | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 768 | #endif | 
 | 769 | #ifndef PyMODINIT_FUNC | 
| Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 770 | #       if defined(__cplusplus) | 
 | 771 | #               define PyMODINIT_FUNC extern "C" PyObject* | 
 | 772 | #       else /* __cplusplus */ | 
 | 773 | #               define PyMODINIT_FUNC PyObject* | 
 | 774 | #       endif /* __cplusplus */ | 
| Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 775 | #endif | 
 | 776 |  | 
| Fred Drake | d5fadf7 | 2000-09-26 05:46:01 +0000 | [diff] [blame] | 777 | /* limits.h constants that may be missing */ | 
 | 778 |  | 
 | 779 | #ifndef INT_MAX | 
 | 780 | #define INT_MAX 2147483647 | 
 | 781 | #endif | 
 | 782 |  | 
 | 783 | #ifndef LONG_MAX | 
 | 784 | #if SIZEOF_LONG == 4 | 
 | 785 | #define LONG_MAX 0X7FFFFFFFL | 
 | 786 | #elif SIZEOF_LONG == 8 | 
 | 787 | #define LONG_MAX 0X7FFFFFFFFFFFFFFFL | 
 | 788 | #else | 
 | 789 | #error "could not set LONG_MAX in pyport.h" | 
 | 790 | #endif | 
 | 791 | #endif | 
 | 792 |  | 
 | 793 | #ifndef LONG_MIN | 
 | 794 | #define LONG_MIN (-LONG_MAX-1) | 
 | 795 | #endif | 
 | 796 |  | 
| Tim Peters | d57731f | 2000-10-05 01:42:25 +0000 | [diff] [blame] | 797 | #ifndef LONG_BIT | 
 | 798 | #define LONG_BIT (8 * SIZEOF_LONG) | 
 | 799 | #endif | 
 | 800 |  | 
 | 801 | #if LONG_BIT != 8 * SIZEOF_LONG | 
 | 802 | /* 04-Oct-2000 LONG_BIT is apparently (mis)defined as 64 on some recent | 
 | 803 |  * 32-bit platforms using gcc.  We try to catch that here at compile-time | 
 | 804 |  * rather than waiting for integer multiplication to trigger bogus | 
 | 805 |  * overflows. | 
 | 806 |  */ | 
| Andrew M. Kuchling | 234fb63 | 2001-01-12 15:06:28 +0000 | [diff] [blame] | 807 | #error "LONG_BIT definition appears wrong for platform (bad gcc/glibc config?)." | 
| Tim Peters | d57731f | 2000-10-05 01:42:25 +0000 | [diff] [blame] | 808 | #endif | 
 | 809 |  | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 810 | #ifdef __cplusplus | 
 | 811 | } | 
 | 812 | #endif | 
 | 813 |  | 
| Neil Schemenauer | 1569108 | 2001-10-23 02:20:37 +0000 | [diff] [blame] | 814 | /* | 
 | 815 |  * Hide GCC attributes from compilers that don't support them. | 
 | 816 |  */ | 
| Guido van Rossum | bd67d6f | 2001-10-27 21:16:16 +0000 | [diff] [blame] | 817 | #if (!defined(__GNUC__) || __GNUC__ < 2 || \ | 
| Skip Montanaro | 7a98be2 | 2007-08-16 14:35:24 +0000 | [diff] [blame] | 818 |      (__GNUC__ == 2 && __GNUC_MINOR__ < 7) ) | 
| Neil Schemenauer | 96aa0ac | 2002-09-15 14:09:54 +0000 | [diff] [blame] | 819 | #define Py_GCC_ATTRIBUTE(x) | 
 | 820 | #else | 
 | 821 | #define Py_GCC_ATTRIBUTE(x) __attribute__(x) | 
| Neil Schemenauer | 1569108 | 2001-10-23 02:20:37 +0000 | [diff] [blame] | 822 | #endif | 
 | 823 |  | 
| Thomas Wouters | 89f507f | 2006-12-13 04:49:30 +0000 | [diff] [blame] | 824 | /* | 
 | 825 |  * Add PyArg_ParseTuple format where available. | 
 | 826 |  */ | 
 | 827 | #ifdef HAVE_ATTRIBUTE_FORMAT_PARSETUPLE | 
 | 828 | #define Py_FORMAT_PARSETUPLE(func,p1,p2) __attribute__((format(func,p1,p2))) | 
 | 829 | #else | 
 | 830 | #define Py_FORMAT_PARSETUPLE(func,p1,p2) | 
 | 831 | #endif | 
 | 832 |  | 
| Benjamin Peterson | 058e31e | 2009-01-16 03:54:08 +0000 | [diff] [blame] | 833 | /* | 
 | 834 |  * Specify alignment on compilers that support it. | 
 | 835 |  */ | 
 | 836 | #if defined(__GNUC__) && __GNUC__ >= 3 | 
 | 837 | #define Py_ALIGNED(x) __attribute__((aligned(x))) | 
 | 838 | #else | 
 | 839 | #define Py_ALIGNED(x) | 
 | 840 | #endif | 
 | 841 |  | 
| Nicholas Bastin | 9ba301e | 2004-07-15 15:54:05 +0000 | [diff] [blame] | 842 | /* Eliminate end-of-loop code not reached warnings from SunPro C | 
 | 843 |  * when using do{...}while(0) macros | 
 | 844 |  */ | 
 | 845 | #ifdef __SUNPRO_C | 
 | 846 | #pragma error_messages (off,E_END_OF_LOOP_CODE_NOT_REACHED) | 
 | 847 | #endif | 
 | 848 |  | 
| Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 849 | /* | 
 | 850 |  * Older Microsoft compilers don't support the C99 long long literal suffixes, | 
 | 851 |  * so these will be defined in PC/pyconfig.h for those compilers. | 
 | 852 |  */ | 
 | 853 | #ifndef Py_LL | 
 | 854 | #define Py_LL(x) x##LL | 
 | 855 | #endif | 
 | 856 |  | 
 | 857 | #ifndef Py_ULL | 
 | 858 | #define Py_ULL(x) Py_LL(x##U) | 
 | 859 | #endif | 
 | 860 |  | 
| Alexander Belopolsky | f0f4514 | 2010-08-11 17:31:17 +0000 | [diff] [blame] | 861 | #ifdef VA_LIST_IS_ARRAY | 
 | 862 | #define Py_VA_COPY(x, y) Py_MEMCPY((x), (y), sizeof(va_list)) | 
 | 863 | #else | 
 | 864 | #ifdef __va_copy | 
 | 865 | #define Py_VA_COPY __va_copy | 
 | 866 | #else | 
 | 867 | #define Py_VA_COPY(x, y) (x) = (y) | 
 | 868 | #endif | 
 | 869 | #endif | 
 | 870 |  | 
| Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 871 | #endif /* Py_PYPORT_H */ |