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