Chris@87: #ifndef Py_PYPORT_H Chris@87: #define Py_PYPORT_H Chris@87: Chris@87: #include "pyconfig.h" /* include for defines */ Chris@87: Chris@87: /* Some versions of HP-UX & Solaris need inttypes.h for int32_t, Chris@87: INT32_MAX, etc. */ Chris@87: #ifdef HAVE_INTTYPES_H Chris@87: #include Chris@87: #endif Chris@87: Chris@87: #ifdef HAVE_STDINT_H Chris@87: #include Chris@87: #endif Chris@87: Chris@87: /************************************************************************** Chris@87: Symbols and macros to supply platform-independent interfaces to basic Chris@87: C language & library operations whose spellings vary across platforms. Chris@87: Chris@87: Please try to make documentation here as clear as possible: by definition, Chris@87: the stuff here is trying to illuminate C's darkest corners. Chris@87: Chris@87: Config #defines referenced here: Chris@87: Chris@87: SIGNED_RIGHT_SHIFT_ZERO_FILLS Chris@87: Meaning: To be defined iff i>>j does not extend the sign bit when i is a Chris@87: signed integral type and i < 0. Chris@87: Used in: Py_ARITHMETIC_RIGHT_SHIFT Chris@87: Chris@87: Py_DEBUG Chris@87: Meaning: Extra checks compiled in for debug mode. Chris@87: Used in: Py_SAFE_DOWNCAST Chris@87: Chris@87: HAVE_UINTPTR_T Chris@87: Meaning: The C9X type uintptr_t is supported by the compiler Chris@87: Used in: Py_uintptr_t Chris@87: Chris@87: HAVE_LONG_LONG Chris@87: Meaning: The compiler supports the C type "long long" Chris@87: Used in: PY_LONG_LONG Chris@87: Chris@87: **************************************************************************/ Chris@87: Chris@87: Chris@87: /* For backward compatibility only. Obsolete, do not use. */ Chris@87: #ifdef HAVE_PROTOTYPES Chris@87: #define Py_PROTO(x) x Chris@87: #else Chris@87: #define Py_PROTO(x) () Chris@87: #endif Chris@87: #ifndef Py_FPROTO Chris@87: #define Py_FPROTO(x) Py_PROTO(x) Chris@87: #endif Chris@87: Chris@87: /* typedefs for some C9X-defined synonyms for integral types. Chris@87: * Chris@87: * The names in Python are exactly the same as the C9X names, except with a Chris@87: * Py_ prefix. Until C9X is universally implemented, this is the only way Chris@87: * to ensure that Python gets reliable names that don't conflict with names Chris@87: * in non-Python code that are playing their own tricks to define the C9X Chris@87: * names. Chris@87: * Chris@87: * NOTE: don't go nuts here! Python has no use for *most* of the C9X Chris@87: * integral synonyms. Only define the ones we actually need. Chris@87: */ Chris@87: Chris@87: #ifdef HAVE_LONG_LONG Chris@87: #ifndef PY_LONG_LONG Chris@87: #define PY_LONG_LONG long long Chris@87: #if defined(LLONG_MAX) Chris@87: /* If LLONG_MAX is defined in limits.h, use that. */ Chris@87: #define PY_LLONG_MIN LLONG_MIN Chris@87: #define PY_LLONG_MAX LLONG_MAX Chris@87: #define PY_ULLONG_MAX ULLONG_MAX Chris@87: #elif defined(__LONG_LONG_MAX__) Chris@87: /* Otherwise, if GCC has a builtin define, use that. */ Chris@87: #define PY_LLONG_MAX __LONG_LONG_MAX__ Chris@87: #define PY_LLONG_MIN (-PY_LLONG_MAX-1) Chris@87: #define PY_ULLONG_MAX (__LONG_LONG_MAX__*2ULL + 1ULL) Chris@87: #else Chris@87: /* Otherwise, rely on two's complement. */ Chris@87: #define PY_ULLONG_MAX (~0ULL) Chris@87: #define PY_LLONG_MAX ((long long)(PY_ULLONG_MAX>>1)) Chris@87: #define PY_LLONG_MIN (-PY_LLONG_MAX-1) Chris@87: #endif /* LLONG_MAX */ Chris@87: #endif Chris@87: #endif /* HAVE_LONG_LONG */ Chris@87: Chris@87: /* a build with 30-bit digits for Python long integers needs an exact-width Chris@87: * 32-bit unsigned integer type to store those digits. (We could just use Chris@87: * type 'unsigned long', but that would be wasteful on a system where longs Chris@87: * are 64-bits.) On Unix systems, the autoconf macro AC_TYPE_UINT32_T defines Chris@87: * uint32_t to be such a type unless stdint.h or inttypes.h defines uint32_t. Chris@87: * However, it doesn't set HAVE_UINT32_T, so we do that here. Chris@87: */ Chris@87: #ifdef uint32_t Chris@87: #define HAVE_UINT32_T 1 Chris@87: #endif Chris@87: Chris@87: #ifdef HAVE_UINT32_T Chris@87: #ifndef PY_UINT32_T Chris@87: #define PY_UINT32_T uint32_t Chris@87: #endif Chris@87: #endif Chris@87: Chris@87: /* Macros for a 64-bit unsigned integer type; used for type 'twodigits' in the Chris@87: * long integer implementation, when 30-bit digits are enabled. Chris@87: */ Chris@87: #ifdef uint64_t Chris@87: #define HAVE_UINT64_T 1 Chris@87: #endif Chris@87: Chris@87: #ifdef HAVE_UINT64_T Chris@87: #ifndef PY_UINT64_T Chris@87: #define PY_UINT64_T uint64_t Chris@87: #endif Chris@87: #endif Chris@87: Chris@87: /* Signed variants of the above */ Chris@87: #ifdef int32_t Chris@87: #define HAVE_INT32_T 1 Chris@87: #endif Chris@87: Chris@87: #ifdef HAVE_INT32_T Chris@87: #ifndef PY_INT32_T Chris@87: #define PY_INT32_T int32_t Chris@87: #endif Chris@87: #endif Chris@87: Chris@87: #ifdef int64_t Chris@87: #define HAVE_INT64_T 1 Chris@87: #endif Chris@87: Chris@87: #ifdef HAVE_INT64_T Chris@87: #ifndef PY_INT64_T Chris@87: #define PY_INT64_T int64_t Chris@87: #endif Chris@87: #endif Chris@87: Chris@87: /* If PYLONG_BITS_IN_DIGIT is not defined then we'll use 30-bit digits if all Chris@87: the necessary integer types are available, and we're on a 64-bit platform Chris@87: (as determined by SIZEOF_VOID_P); otherwise we use 15-bit digits. */ Chris@87: Chris@87: #ifndef PYLONG_BITS_IN_DIGIT Chris@87: #if (defined HAVE_UINT64_T && defined HAVE_INT64_T && \ Chris@87: defined HAVE_UINT32_T && defined HAVE_INT32_T && SIZEOF_VOID_P >= 8) Chris@87: #define PYLONG_BITS_IN_DIGIT 30 Chris@87: #else Chris@87: #define PYLONG_BITS_IN_DIGIT 15 Chris@87: #endif Chris@87: #endif Chris@87: Chris@87: /* uintptr_t is the C9X name for an unsigned integral type such that a Chris@87: * legitimate void* can be cast to uintptr_t and then back to void* again Chris@87: * without loss of information. Similarly for intptr_t, wrt a signed Chris@87: * integral type. Chris@87: */ Chris@87: #ifdef HAVE_UINTPTR_T Chris@87: typedef uintptr_t Py_uintptr_t; Chris@87: typedef intptr_t Py_intptr_t; Chris@87: Chris@87: #elif SIZEOF_VOID_P <= SIZEOF_INT Chris@87: typedef unsigned int Py_uintptr_t; Chris@87: typedef int Py_intptr_t; Chris@87: Chris@87: #elif SIZEOF_VOID_P <= SIZEOF_LONG Chris@87: typedef unsigned long Py_uintptr_t; Chris@87: typedef long Py_intptr_t; Chris@87: Chris@87: #elif defined(HAVE_LONG_LONG) && (SIZEOF_VOID_P <= SIZEOF_LONG_LONG) Chris@87: typedef unsigned PY_LONG_LONG Py_uintptr_t; Chris@87: typedef PY_LONG_LONG Py_intptr_t; Chris@87: Chris@87: #else Chris@87: # error "Python needs a typedef for Py_uintptr_t in pyport.h." Chris@87: #endif /* HAVE_UINTPTR_T */ Chris@87: Chris@87: /* Py_ssize_t is a signed integral type such that sizeof(Py_ssize_t) == Chris@87: * sizeof(size_t). C99 doesn't define such a thing directly (size_t is an Chris@87: * unsigned integral type). See PEP 353 for details. Chris@87: */ Chris@87: #ifdef HAVE_SSIZE_T Chris@87: typedef ssize_t Py_ssize_t; Chris@87: #elif SIZEOF_VOID_P == SIZEOF_SIZE_T Chris@87: typedef Py_intptr_t Py_ssize_t; Chris@87: #else Chris@87: # error "Python needs a typedef for Py_ssize_t in pyport.h." Chris@87: #endif Chris@87: Chris@87: /* Largest possible value of size_t. Chris@87: SIZE_MAX is part of C99, so it might be defined on some Chris@87: platforms. If it is not defined, (size_t)-1 is a portable Chris@87: definition for C89, due to the way signed->unsigned Chris@87: conversion is defined. */ Chris@87: #ifdef SIZE_MAX Chris@87: #define PY_SIZE_MAX SIZE_MAX Chris@87: #else Chris@87: #define PY_SIZE_MAX ((size_t)-1) Chris@87: #endif Chris@87: Chris@87: /* Largest positive value of type Py_ssize_t. */ Chris@87: #define PY_SSIZE_T_MAX ((Py_ssize_t)(((size_t)-1)>>1)) Chris@87: /* Smallest negative value of type Py_ssize_t. */ Chris@87: #define PY_SSIZE_T_MIN (-PY_SSIZE_T_MAX-1) Chris@87: Chris@87: #if SIZEOF_PID_T > SIZEOF_LONG Chris@87: # error "Python doesn't support sizeof(pid_t) > sizeof(long)" Chris@87: #endif Chris@87: Chris@87: /* PY_FORMAT_SIZE_T is a platform-specific modifier for use in a printf Chris@87: * format to convert an argument with the width of a size_t or Py_ssize_t. Chris@87: * C99 introduced "z" for this purpose, but not all platforms support that; Chris@87: * e.g., MS compilers use "I" instead. Chris@87: * Chris@87: * These "high level" Python format functions interpret "z" correctly on Chris@87: * all platforms (Python interprets the format string itself, and does whatever Chris@87: * the platform C requires to convert a size_t/Py_ssize_t argument): Chris@87: * Chris@87: * PyString_FromFormat Chris@87: * PyErr_Format Chris@87: * PyString_FromFormatV Chris@87: * Chris@87: * Lower-level uses require that you interpolate the correct format modifier Chris@87: * yourself (e.g., calling printf, fprintf, sprintf, PyOS_snprintf); for Chris@87: * example, Chris@87: * Chris@87: * Py_ssize_t index; Chris@87: * fprintf(stderr, "index %" PY_FORMAT_SIZE_T "d sucks\n", index); Chris@87: * Chris@87: * That will expand to %ld, or %Id, or to something else correct for a Chris@87: * Py_ssize_t on the platform. Chris@87: */ Chris@87: #ifndef PY_FORMAT_SIZE_T Chris@87: # if SIZEOF_SIZE_T == SIZEOF_INT && !defined(__APPLE__) Chris@87: # define PY_FORMAT_SIZE_T "" Chris@87: # elif SIZEOF_SIZE_T == SIZEOF_LONG Chris@87: # define PY_FORMAT_SIZE_T "l" Chris@87: # elif defined(MS_WINDOWS) Chris@87: # define PY_FORMAT_SIZE_T "I" Chris@87: # else Chris@87: # error "This platform's pyconfig.h needs to define PY_FORMAT_SIZE_T" Chris@87: # endif Chris@87: #endif Chris@87: Chris@87: /* PY_FORMAT_LONG_LONG is analogous to PY_FORMAT_SIZE_T above, but for Chris@87: * the long long type instead of the size_t type. It's only available Chris@87: * when HAVE_LONG_LONG is defined. The "high level" Python format Chris@87: * functions listed above will interpret "lld" or "llu" correctly on Chris@87: * all platforms. Chris@87: */ Chris@87: #ifdef HAVE_LONG_LONG Chris@87: # ifndef PY_FORMAT_LONG_LONG Chris@87: # if defined(MS_WIN64) || defined(MS_WINDOWS) Chris@87: # define PY_FORMAT_LONG_LONG "I64" Chris@87: # else Chris@87: # error "This platform's pyconfig.h needs to define PY_FORMAT_LONG_LONG" Chris@87: # endif Chris@87: # endif Chris@87: #endif Chris@87: Chris@87: /* Py_LOCAL can be used instead of static to get the fastest possible calling Chris@87: * convention for functions that are local to a given module. Chris@87: * Chris@87: * Py_LOCAL_INLINE does the same thing, and also explicitly requests inlining, Chris@87: * for platforms that support that. Chris@87: * Chris@87: * If PY_LOCAL_AGGRESSIVE is defined before python.h is included, more Chris@87: * "aggressive" inlining/optimizaion is enabled for the entire module. This Chris@87: * may lead to code bloat, and may slow things down for those reasons. It may Chris@87: * also lead to errors, if the code relies on pointer aliasing. Use with Chris@87: * care. Chris@87: * Chris@87: * NOTE: You can only use this for functions that are entirely local to a Chris@87: * module; functions that are exported via method tables, callbacks, etc, Chris@87: * should keep using static. Chris@87: */ Chris@87: Chris@87: #undef USE_INLINE /* XXX - set via configure? */ Chris@87: Chris@87: #if defined(_MSC_VER) Chris@87: #if defined(PY_LOCAL_AGGRESSIVE) Chris@87: /* enable more aggressive optimization for visual studio */ Chris@87: #pragma optimize("agtw", on) Chris@87: #endif Chris@87: /* ignore warnings if the compiler decides not to inline a function */ Chris@87: #pragma warning(disable: 4710) Chris@87: /* fastest possible local call under MSVC */ Chris@87: #define Py_LOCAL(type) static type __fastcall Chris@87: #define Py_LOCAL_INLINE(type) static __inline type __fastcall Chris@87: #elif defined(USE_INLINE) Chris@87: #define Py_LOCAL(type) static type Chris@87: #define Py_LOCAL_INLINE(type) static inline type Chris@87: #else Chris@87: #define Py_LOCAL(type) static type Chris@87: #define Py_LOCAL_INLINE(type) static type Chris@87: #endif Chris@87: Chris@87: /* Py_MEMCPY can be used instead of memcpy in cases where the copied blocks Chris@87: * are often very short. While most platforms have highly optimized code for Chris@87: * large transfers, the setup costs for memcpy are often quite high. MEMCPY Chris@87: * solves this by doing short copies "in line". Chris@87: */ Chris@87: Chris@87: #if defined(_MSC_VER) Chris@87: #define Py_MEMCPY(target, source, length) do { \ Chris@87: size_t i_, n_ = (length); \ Chris@87: char *t_ = (void*) (target); \ Chris@87: const char *s_ = (void*) (source); \ Chris@87: if (n_ >= 16) \ Chris@87: memcpy(t_, s_, n_); \ Chris@87: else \ Chris@87: for (i_ = 0; i_ < n_; i_++) \ Chris@87: t_[i_] = s_[i_]; \ Chris@87: } while (0) Chris@87: #else Chris@87: #define Py_MEMCPY memcpy Chris@87: #endif Chris@87: Chris@87: #include Chris@87: Chris@87: #ifdef HAVE_IEEEFP_H Chris@87: #include /* needed for 'finite' declaration on some platforms */ Chris@87: #endif Chris@87: Chris@87: #include /* Moved here from the math section, before extern "C" */ Chris@87: Chris@87: /******************************************** Chris@87: * WRAPPER FOR and/or * Chris@87: ********************************************/ Chris@87: Chris@87: #ifdef TIME_WITH_SYS_TIME Chris@87: #include Chris@87: #include Chris@87: #else /* !TIME_WITH_SYS_TIME */ Chris@87: #ifdef HAVE_SYS_TIME_H Chris@87: #include Chris@87: #else /* !HAVE_SYS_TIME_H */ Chris@87: #include Chris@87: #endif /* !HAVE_SYS_TIME_H */ Chris@87: #endif /* !TIME_WITH_SYS_TIME */ Chris@87: Chris@87: Chris@87: /****************************** Chris@87: * WRAPPER FOR * Chris@87: ******************************/ Chris@87: Chris@87: /* NB caller must include */ Chris@87: Chris@87: #ifdef HAVE_SYS_SELECT_H Chris@87: Chris@87: #include Chris@87: Chris@87: #endif /* !HAVE_SYS_SELECT_H */ Chris@87: Chris@87: /******************************* Chris@87: * stat() and fstat() fiddling * Chris@87: *******************************/ Chris@87: Chris@87: /* We expect that stat and fstat exist on most systems. Chris@87: * It's confirmed on Unix, Mac and Windows. Chris@87: * If you don't have them, add Chris@87: * #define DONT_HAVE_STAT Chris@87: * and/or Chris@87: * #define DONT_HAVE_FSTAT Chris@87: * to your pyconfig.h. Python code beyond this should check HAVE_STAT and Chris@87: * HAVE_FSTAT instead. Chris@87: * Also Chris@87: * #define HAVE_SYS_STAT_H Chris@87: * if exists on your platform, and Chris@87: * #define HAVE_STAT_H Chris@87: * if does. Chris@87: */ Chris@87: #ifndef DONT_HAVE_STAT Chris@87: #define HAVE_STAT Chris@87: #endif Chris@87: Chris@87: #ifndef DONT_HAVE_FSTAT Chris@87: #define HAVE_FSTAT Chris@87: #endif Chris@87: Chris@87: #ifdef RISCOS Chris@87: #include Chris@87: #include "unixstuff.h" Chris@87: #endif Chris@87: Chris@87: #ifdef HAVE_SYS_STAT_H Chris@87: #if defined(PYOS_OS2) && defined(PYCC_GCC) Chris@87: #include Chris@87: #endif Chris@87: #include Chris@87: #elif defined(HAVE_STAT_H) Chris@87: #include Chris@87: #endif Chris@87: Chris@87: #if defined(PYCC_VACPP) Chris@87: /* VisualAge C/C++ Failed to Define MountType Field in sys/stat.h */ Chris@87: #define S_IFMT (S_IFDIR|S_IFCHR|S_IFREG) Chris@87: #endif Chris@87: Chris@87: #ifndef S_ISREG Chris@87: #define S_ISREG(x) (((x) & S_IFMT) == S_IFREG) Chris@87: #endif Chris@87: Chris@87: #ifndef S_ISDIR Chris@87: #define S_ISDIR(x) (((x) & S_IFMT) == S_IFDIR) Chris@87: #endif Chris@87: Chris@87: Chris@87: #ifdef __cplusplus Chris@87: /* Move this down here since some C++ #include's don't like to be included Chris@87: inside an extern "C" */ Chris@87: extern "C" { Chris@87: #endif Chris@87: Chris@87: Chris@87: /* Py_ARITHMETIC_RIGHT_SHIFT Chris@87: * C doesn't define whether a right-shift of a signed integer sign-extends Chris@87: * or zero-fills. Here a macro to force sign extension: Chris@87: * Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) Chris@87: * Return I >> J, forcing sign extension. Arithmetically, return the Chris@87: * floor of I/2**J. Chris@87: * Requirements: Chris@87: * I should have signed integer type. In the terminology of C99, this can Chris@87: * be either one of the five standard signed integer types (signed char, Chris@87: * short, int, long, long long) or an extended signed integer type. Chris@87: * J is an integer >= 0 and strictly less than the number of bits in the Chris@87: * type of I (because C doesn't define what happens for J outside that Chris@87: * range either). Chris@87: * TYPE used to specify the type of I, but is now ignored. It's been left Chris@87: * in for backwards compatibility with versions <= 2.6 or 3.0. Chris@87: * Caution: Chris@87: * I may be evaluated more than once. Chris@87: */ Chris@87: #ifdef SIGNED_RIGHT_SHIFT_ZERO_FILLS Chris@87: #define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) \ Chris@87: ((I) < 0 ? -1-((-1-(I)) >> (J)) : (I) >> (J)) Chris@87: #else Chris@87: #define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) ((I) >> (J)) Chris@87: #endif Chris@87: Chris@87: /* Py_FORCE_EXPANSION(X) Chris@87: * "Simply" returns its argument. However, macro expansions within the Chris@87: * argument are evaluated. This unfortunate trickery is needed to get Chris@87: * token-pasting to work as desired in some cases. Chris@87: */ Chris@87: #define Py_FORCE_EXPANSION(X) X Chris@87: Chris@87: /* Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) Chris@87: * Cast VALUE to type NARROW from type WIDE. In Py_DEBUG mode, this Chris@87: * assert-fails if any information is lost. Chris@87: * Caution: Chris@87: * VALUE may be evaluated more than once. Chris@87: */ Chris@87: #ifdef Py_DEBUG Chris@87: #define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) \ Chris@87: (assert((WIDE)(NARROW)(VALUE) == (VALUE)), (NARROW)(VALUE)) Chris@87: #else Chris@87: #define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) (NARROW)(VALUE) Chris@87: #endif Chris@87: Chris@87: /* Py_SET_ERRNO_ON_MATH_ERROR(x) Chris@87: * If a libm function did not set errno, but it looks like the result Chris@87: * overflowed or not-a-number, set errno to ERANGE or EDOM. Set errno Chris@87: * to 0 before calling a libm function, and invoke this macro after, Chris@87: * passing the function result. Chris@87: * Caution: Chris@87: * This isn't reliable. See Py_OVERFLOWED comments. Chris@87: * X is evaluated more than once. Chris@87: */ Chris@87: #if defined(__FreeBSD__) || defined(__OpenBSD__) || (defined(__hpux) && defined(__ia64)) Chris@87: #define _Py_SET_EDOM_FOR_NAN(X) if (isnan(X)) errno = EDOM; Chris@87: #else Chris@87: #define _Py_SET_EDOM_FOR_NAN(X) ; Chris@87: #endif Chris@87: #define Py_SET_ERRNO_ON_MATH_ERROR(X) \ Chris@87: do { \ Chris@87: if (errno == 0) { \ Chris@87: if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL) \ Chris@87: errno = ERANGE; \ Chris@87: else _Py_SET_EDOM_FOR_NAN(X) \ Chris@87: } \ Chris@87: } while(0) Chris@87: Chris@87: /* Py_SET_ERANGE_ON_OVERFLOW(x) Chris@87: * An alias of Py_SET_ERRNO_ON_MATH_ERROR for backward-compatibility. Chris@87: */ Chris@87: #define Py_SET_ERANGE_IF_OVERFLOW(X) Py_SET_ERRNO_ON_MATH_ERROR(X) Chris@87: Chris@87: /* Py_ADJUST_ERANGE1(x) Chris@87: * Py_ADJUST_ERANGE2(x, y) Chris@87: * Set errno to 0 before calling a libm function, and invoke one of these Chris@87: * macros after, passing the function result(s) (Py_ADJUST_ERANGE2 is useful Chris@87: * for functions returning complex results). This makes two kinds of Chris@87: * adjustments to errno: (A) If it looks like the platform libm set Chris@87: * errno=ERANGE due to underflow, clear errno. (B) If it looks like the Chris@87: * platform libm overflowed but didn't set errno, force errno to ERANGE. In Chris@87: * effect, we're trying to force a useful implementation of C89 errno Chris@87: * behavior. Chris@87: * Caution: Chris@87: * This isn't reliable. See Py_OVERFLOWED comments. Chris@87: * X and Y may be evaluated more than once. Chris@87: */ Chris@87: #define Py_ADJUST_ERANGE1(X) \ Chris@87: do { \ Chris@87: if (errno == 0) { \ Chris@87: if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL) \ Chris@87: errno = ERANGE; \ Chris@87: } \ Chris@87: else if (errno == ERANGE && (X) == 0.0) \ Chris@87: errno = 0; \ Chris@87: } while(0) Chris@87: Chris@87: #define Py_ADJUST_ERANGE2(X, Y) \ Chris@87: do { \ Chris@87: if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL || \ Chris@87: (Y) == Py_HUGE_VAL || (Y) == -Py_HUGE_VAL) { \ Chris@87: if (errno == 0) \ Chris@87: errno = ERANGE; \ Chris@87: } \ Chris@87: else if (errno == ERANGE) \ Chris@87: errno = 0; \ Chris@87: } while(0) Chris@87: Chris@87: /* The functions _Py_dg_strtod and _Py_dg_dtoa in Python/dtoa.c (which are Chris@87: * required to support the short float repr introduced in Python 3.1) require Chris@87: * that the floating-point unit that's being used for arithmetic operations Chris@87: * on C doubles is set to use 53-bit precision. It also requires that the Chris@87: * FPU rounding mode is round-half-to-even, but that's less often an issue. Chris@87: * Chris@87: * If your FPU isn't already set to 53-bit precision/round-half-to-even, and Chris@87: * you want to make use of _Py_dg_strtod and _Py_dg_dtoa, then you should Chris@87: * Chris@87: * #define HAVE_PY_SET_53BIT_PRECISION 1 Chris@87: * Chris@87: * and also give appropriate definitions for the following three macros: Chris@87: * Chris@87: * _PY_SET_53BIT_PRECISION_START : store original FPU settings, and Chris@87: * set FPU to 53-bit precision/round-half-to-even Chris@87: * _PY_SET_53BIT_PRECISION_END : restore original FPU settings Chris@87: * _PY_SET_53BIT_PRECISION_HEADER : any variable declarations needed to Chris@87: * use the two macros above. Chris@87: * Chris@87: * The macros are designed to be used within a single C function: see Chris@87: * Python/pystrtod.c for an example of their use. Chris@87: */ Chris@87: Chris@87: /* get and set x87 control word for gcc/x86 */ Chris@87: #ifdef HAVE_GCC_ASM_FOR_X87 Chris@87: #define HAVE_PY_SET_53BIT_PRECISION 1 Chris@87: /* _Py_get/set_387controlword functions are defined in Python/pymath.c */ Chris@87: #define _Py_SET_53BIT_PRECISION_HEADER \ Chris@87: unsigned short old_387controlword, new_387controlword Chris@87: #define _Py_SET_53BIT_PRECISION_START \ Chris@87: do { \ Chris@87: old_387controlword = _Py_get_387controlword(); \ Chris@87: new_387controlword = (old_387controlword & ~0x0f00) | 0x0200; \ Chris@87: if (new_387controlword != old_387controlword) \ Chris@87: _Py_set_387controlword(new_387controlword); \ Chris@87: } while (0) Chris@87: #define _Py_SET_53BIT_PRECISION_END \ Chris@87: if (new_387controlword != old_387controlword) \ Chris@87: _Py_set_387controlword(old_387controlword) Chris@87: #endif Chris@87: Chris@87: /* get and set x87 control word for VisualStudio/x86 */ Chris@87: #if defined(_MSC_VER) && !defined(_WIN64) /* x87 not supported in 64-bit */ Chris@87: #define HAVE_PY_SET_53BIT_PRECISION 1 Chris@87: #define _Py_SET_53BIT_PRECISION_HEADER \ Chris@87: unsigned int old_387controlword, new_387controlword, out_387controlword Chris@87: /* We use the __control87_2 function to set only the x87 control word. Chris@87: The SSE control word is unaffected. */ Chris@87: #define _Py_SET_53BIT_PRECISION_START \ Chris@87: do { \ Chris@87: __control87_2(0, 0, &old_387controlword, NULL); \ Chris@87: new_387controlword = \ Chris@87: (old_387controlword & ~(_MCW_PC | _MCW_RC)) | (_PC_53 | _RC_NEAR); \ Chris@87: if (new_387controlword != old_387controlword) \ Chris@87: __control87_2(new_387controlword, _MCW_PC | _MCW_RC, \ Chris@87: &out_387controlword, NULL); \ Chris@87: } while (0) Chris@87: #define _Py_SET_53BIT_PRECISION_END \ Chris@87: do { \ Chris@87: if (new_387controlword != old_387controlword) \ Chris@87: __control87_2(old_387controlword, _MCW_PC | _MCW_RC, \ Chris@87: &out_387controlword, NULL); \ Chris@87: } while (0) Chris@87: #endif Chris@87: Chris@87: /* default definitions are empty */ Chris@87: #ifndef HAVE_PY_SET_53BIT_PRECISION Chris@87: #define _Py_SET_53BIT_PRECISION_HEADER Chris@87: #define _Py_SET_53BIT_PRECISION_START Chris@87: #define _Py_SET_53BIT_PRECISION_END Chris@87: #endif Chris@87: Chris@87: /* If we can't guarantee 53-bit precision, don't use the code Chris@87: in Python/dtoa.c, but fall back to standard code. This Chris@87: means that repr of a float will be long (17 sig digits). Chris@87: Chris@87: Realistically, there are two things that could go wrong: Chris@87: Chris@87: (1) doubles aren't IEEE 754 doubles, or Chris@87: (2) we're on x86 with the rounding precision set to 64-bits Chris@87: (extended precision), and we don't know how to change Chris@87: the rounding precision. Chris@87: */ Chris@87: Chris@87: #if !defined(DOUBLE_IS_LITTLE_ENDIAN_IEEE754) && \ Chris@87: !defined(DOUBLE_IS_BIG_ENDIAN_IEEE754) && \ Chris@87: !defined(DOUBLE_IS_ARM_MIXED_ENDIAN_IEEE754) Chris@87: #define PY_NO_SHORT_FLOAT_REPR Chris@87: #endif Chris@87: Chris@87: /* double rounding is symptomatic of use of extended precision on x86. If Chris@87: we're seeing double rounding, and we don't have any mechanism available for Chris@87: changing the FPU rounding precision, then don't use Python/dtoa.c. */ Chris@87: #if defined(X87_DOUBLE_ROUNDING) && !defined(HAVE_PY_SET_53BIT_PRECISION) Chris@87: #define PY_NO_SHORT_FLOAT_REPR Chris@87: #endif Chris@87: Chris@87: /* Py_DEPRECATED(version) Chris@87: * Declare a variable, type, or function deprecated. Chris@87: * Usage: Chris@87: * extern int old_var Py_DEPRECATED(2.3); Chris@87: * typedef int T1 Py_DEPRECATED(2.4); Chris@87: * extern int x() Py_DEPRECATED(2.5); Chris@87: */ Chris@87: #if defined(__GNUC__) && ((__GNUC__ >= 4) || \ Chris@87: (__GNUC__ == 3) && (__GNUC_MINOR__ >= 1)) Chris@87: #define Py_DEPRECATED(VERSION_UNUSED) __attribute__((__deprecated__)) Chris@87: #else Chris@87: #define Py_DEPRECATED(VERSION_UNUSED) Chris@87: #endif Chris@87: Chris@87: /************************************************************************** Chris@87: Prototypes that are missing from the standard include files on some systems Chris@87: (and possibly only some versions of such systems.) Chris@87: Chris@87: Please be conservative with adding new ones, document them and enclose them Chris@87: in platform-specific #ifdefs. Chris@87: **************************************************************************/ Chris@87: Chris@87: #ifdef SOLARIS Chris@87: /* Unchecked */ Chris@87: extern int gethostname(char *, int); Chris@87: #endif Chris@87: Chris@87: #ifdef __BEOS__ Chris@87: /* Unchecked */ Chris@87: /* It's in the libs, but not the headers... - [cjh] */ Chris@87: int shutdown( int, int ); Chris@87: #endif Chris@87: Chris@87: #ifdef HAVE__GETPTY Chris@87: #include /* we need to import mode_t */ Chris@87: extern char * _getpty(int *, int, mode_t, int); Chris@87: #endif Chris@87: Chris@87: /* On QNX 6, struct termio must be declared by including sys/termio.h Chris@87: if TCGETA, TCSETA, TCSETAW, or TCSETAF are used. sys/termio.h must Chris@87: be included before termios.h or it will generate an error. */ Chris@87: #if defined(HAVE_SYS_TERMIO_H) && !defined(__hpux) Chris@87: #include Chris@87: #endif Chris@87: Chris@87: #if defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) Chris@87: #if !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H) && !defined(HAVE_UTIL_H) Chris@87: /* BSDI does not supply a prototype for the 'openpty' and 'forkpty' Chris@87: functions, even though they are included in libutil. */ Chris@87: #include Chris@87: extern int openpty(int *, int *, char *, struct termios *, struct winsize *); Chris@87: extern pid_t forkpty(int *, char *, struct termios *, struct winsize *); Chris@87: #endif /* !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H) */ Chris@87: #endif /* defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) */ Chris@87: Chris@87: Chris@87: /* These are pulled from various places. It isn't obvious on what platforms Chris@87: they are necessary, nor what the exact prototype should look like (which Chris@87: is likely to vary between platforms!) If you find you need one of these Chris@87: declarations, please move them to a platform-specific block and include Chris@87: proper prototypes. */ Chris@87: #if 0 Chris@87: Chris@87: /* From Modules/resource.c */ Chris@87: extern int getrusage(); Chris@87: extern int getpagesize(); Chris@87: Chris@87: /* From Python/sysmodule.c and Modules/posixmodule.c */ Chris@87: extern int fclose(FILE *); Chris@87: Chris@87: /* From Modules/posixmodule.c */ Chris@87: extern int fdatasync(int); Chris@87: #endif /* 0 */ Chris@87: Chris@87: Chris@87: /* On 4.4BSD-descendants, ctype functions serves the whole range of Chris@87: * wchar_t character set rather than single byte code points only. Chris@87: * This characteristic can break some operations of string object Chris@87: * including str.upper() and str.split() on UTF-8 locales. This Chris@87: * workaround was provided by Tim Robbins of FreeBSD project. Chris@87: */ Chris@87: Chris@87: #ifdef __FreeBSD__ Chris@87: #include Chris@87: #if __FreeBSD_version > 500039 Chris@87: # define _PY_PORT_CTYPE_UTF8_ISSUE Chris@87: #endif Chris@87: #endif Chris@87: Chris@87: Chris@87: #if defined(__APPLE__) Chris@87: # define _PY_PORT_CTYPE_UTF8_ISSUE Chris@87: #endif Chris@87: Chris@87: #ifdef _PY_PORT_CTYPE_UTF8_ISSUE Chris@87: #include Chris@87: #include Chris@87: #undef isalnum Chris@87: #define isalnum(c) iswalnum(btowc(c)) Chris@87: #undef isalpha Chris@87: #define isalpha(c) iswalpha(btowc(c)) Chris@87: #undef islower Chris@87: #define islower(c) iswlower(btowc(c)) Chris@87: #undef isspace Chris@87: #define isspace(c) iswspace(btowc(c)) Chris@87: #undef isupper Chris@87: #define isupper(c) iswupper(btowc(c)) Chris@87: #undef tolower Chris@87: #define tolower(c) towlower(btowc(c)) Chris@87: #undef toupper Chris@87: #define toupper(c) towupper(btowc(c)) Chris@87: #endif Chris@87: Chris@87: Chris@87: /* Declarations for symbol visibility. Chris@87: Chris@87: PyAPI_FUNC(type): Declares a public Python API function and return type Chris@87: PyAPI_DATA(type): Declares public Python data and its type Chris@87: PyMODINIT_FUNC: A Python module init function. If these functions are Chris@87: inside the Python core, they are private to the core. Chris@87: If in an extension module, it may be declared with Chris@87: external linkage depending on the platform. Chris@87: Chris@87: As a number of platforms support/require "__declspec(dllimport/dllexport)", Chris@87: we support a HAVE_DECLSPEC_DLL macro to save duplication. Chris@87: */ Chris@87: Chris@87: /* Chris@87: All windows ports, except cygwin, are handled in PC/pyconfig.h. Chris@87: Chris@87: BeOS and cygwin are the only other autoconf platform requiring special Chris@87: linkage handling and both of these use __declspec(). Chris@87: */ Chris@87: #if defined(__CYGWIN__) || defined(__BEOS__) Chris@87: # define HAVE_DECLSPEC_DLL Chris@87: #endif Chris@87: Chris@87: /* only get special linkage if built as shared or platform is Cygwin */ Chris@87: #if defined(Py_ENABLE_SHARED) || defined(__CYGWIN__) Chris@87: # if defined(HAVE_DECLSPEC_DLL) Chris@87: # ifdef Py_BUILD_CORE Chris@87: # define PyAPI_FUNC(RTYPE) __declspec(dllexport) RTYPE Chris@87: # define PyAPI_DATA(RTYPE) extern __declspec(dllexport) RTYPE Chris@87: /* module init functions inside the core need no external linkage */ Chris@87: /* except for Cygwin to handle embedding (FIXME: BeOS too?) */ Chris@87: # if defined(__CYGWIN__) Chris@87: # define PyMODINIT_FUNC __declspec(dllexport) void Chris@87: # else /* __CYGWIN__ */ Chris@87: # define PyMODINIT_FUNC void Chris@87: # endif /* __CYGWIN__ */ Chris@87: # else /* Py_BUILD_CORE */ Chris@87: /* Building an extension module, or an embedded situation */ Chris@87: /* public Python functions and data are imported */ Chris@87: /* Under Cygwin, auto-import functions to prevent compilation */ Chris@87: /* failures similar to those described at the bottom of 4.1: */ Chris@87: /* http://docs.python.org/extending/windows.html#a-cookbook-approach */ Chris@87: # if !defined(__CYGWIN__) Chris@87: # define PyAPI_FUNC(RTYPE) __declspec(dllimport) RTYPE Chris@87: # endif /* !__CYGWIN__ */ Chris@87: # define PyAPI_DATA(RTYPE) extern __declspec(dllimport) RTYPE Chris@87: /* module init functions outside the core must be exported */ Chris@87: # if defined(__cplusplus) Chris@87: # define PyMODINIT_FUNC extern "C" __declspec(dllexport) void Chris@87: # else /* __cplusplus */ Chris@87: # define PyMODINIT_FUNC __declspec(dllexport) void Chris@87: # endif /* __cplusplus */ Chris@87: # endif /* Py_BUILD_CORE */ Chris@87: # endif /* HAVE_DECLSPEC */ Chris@87: #endif /* Py_ENABLE_SHARED */ Chris@87: Chris@87: /* If no external linkage macros defined by now, create defaults */ Chris@87: #ifndef PyAPI_FUNC Chris@87: # define PyAPI_FUNC(RTYPE) RTYPE Chris@87: #endif Chris@87: #ifndef PyAPI_DATA Chris@87: # define PyAPI_DATA(RTYPE) extern RTYPE Chris@87: #endif Chris@87: #ifndef PyMODINIT_FUNC Chris@87: # if defined(__cplusplus) Chris@87: # define PyMODINIT_FUNC extern "C" void Chris@87: # else /* __cplusplus */ Chris@87: # define PyMODINIT_FUNC void Chris@87: # endif /* __cplusplus */ Chris@87: #endif Chris@87: Chris@87: /* Deprecated DL_IMPORT and DL_EXPORT macros */ Chris@87: #if defined(Py_ENABLE_SHARED) && defined (HAVE_DECLSPEC_DLL) Chris@87: # if defined(Py_BUILD_CORE) Chris@87: # define DL_IMPORT(RTYPE) __declspec(dllexport) RTYPE Chris@87: # define DL_EXPORT(RTYPE) __declspec(dllexport) RTYPE Chris@87: # else Chris@87: # define DL_IMPORT(RTYPE) __declspec(dllimport) RTYPE Chris@87: # define DL_EXPORT(RTYPE) __declspec(dllexport) RTYPE Chris@87: # endif Chris@87: #endif Chris@87: #ifndef DL_EXPORT Chris@87: # define DL_EXPORT(RTYPE) RTYPE Chris@87: #endif Chris@87: #ifndef DL_IMPORT Chris@87: # define DL_IMPORT(RTYPE) RTYPE Chris@87: #endif Chris@87: /* End of deprecated DL_* macros */ Chris@87: Chris@87: /* If the fd manipulation macros aren't defined, Chris@87: here is a set that should do the job */ Chris@87: Chris@87: #if 0 /* disabled and probably obsolete */ Chris@87: Chris@87: #ifndef FD_SETSIZE Chris@87: #define FD_SETSIZE 256 Chris@87: #endif Chris@87: Chris@87: #ifndef FD_SET Chris@87: Chris@87: typedef long fd_mask; Chris@87: Chris@87: #define NFDBITS (sizeof(fd_mask) * NBBY) /* bits per mask */ Chris@87: #ifndef howmany Chris@87: #define howmany(x, y) (((x)+((y)-1))/(y)) Chris@87: #endif /* howmany */ Chris@87: Chris@87: typedef struct fd_set { Chris@87: fd_mask fds_bits[howmany(FD_SETSIZE, NFDBITS)]; Chris@87: } fd_set; Chris@87: Chris@87: #define FD_SET(n, p) ((p)->fds_bits[(n)/NFDBITS] |= (1 << ((n) % NFDBITS))) Chris@87: #define FD_CLR(n, p) ((p)->fds_bits[(n)/NFDBITS] &= ~(1 << ((n) % NFDBITS))) Chris@87: #define FD_ISSET(n, p) ((p)->fds_bits[(n)/NFDBITS] & (1 << ((n) % NFDBITS))) Chris@87: #define FD_ZERO(p) memset((char *)(p), '\0', sizeof(*(p))) Chris@87: Chris@87: #endif /* FD_SET */ Chris@87: Chris@87: #endif /* fd manipulation macros */ Chris@87: Chris@87: Chris@87: /* limits.h constants that may be missing */ Chris@87: Chris@87: #ifndef INT_MAX Chris@87: #define INT_MAX 2147483647 Chris@87: #endif Chris@87: Chris@87: #ifndef LONG_MAX Chris@87: #if SIZEOF_LONG == 4 Chris@87: #define LONG_MAX 0X7FFFFFFFL Chris@87: #elif SIZEOF_LONG == 8 Chris@87: #define LONG_MAX 0X7FFFFFFFFFFFFFFFL Chris@87: #else Chris@87: #error "could not set LONG_MAX in pyport.h" Chris@87: #endif Chris@87: #endif Chris@87: Chris@87: #ifndef LONG_MIN Chris@87: #define LONG_MIN (-LONG_MAX-1) Chris@87: #endif Chris@87: Chris@87: #ifndef LONG_BIT Chris@87: #define LONG_BIT (8 * SIZEOF_LONG) Chris@87: #endif Chris@87: Chris@87: #if LONG_BIT != 8 * SIZEOF_LONG Chris@87: /* 04-Oct-2000 LONG_BIT is apparently (mis)defined as 64 on some recent Chris@87: * 32-bit platforms using gcc. We try to catch that here at compile-time Chris@87: * rather than waiting for integer multiplication to trigger bogus Chris@87: * overflows. Chris@87: */ Chris@87: #error "LONG_BIT definition appears wrong for platform (bad gcc/glibc config?)." Chris@87: #endif Chris@87: Chris@87: #ifdef __cplusplus Chris@87: } Chris@87: #endif Chris@87: Chris@87: /* Chris@87: * Hide GCC attributes from compilers that don't support them. Chris@87: */ Chris@87: #if (!defined(__GNUC__) || __GNUC__ < 2 || \ Chris@87: (__GNUC__ == 2 && __GNUC_MINOR__ < 7) ) && \ Chris@87: !defined(RISCOS) Chris@87: #define Py_GCC_ATTRIBUTE(x) Chris@87: #else Chris@87: #define Py_GCC_ATTRIBUTE(x) __attribute__(x) Chris@87: #endif Chris@87: Chris@87: /* Chris@87: * Add PyArg_ParseTuple format where available. Chris@87: */ Chris@87: #ifdef HAVE_ATTRIBUTE_FORMAT_PARSETUPLE Chris@87: #define Py_FORMAT_PARSETUPLE(func,p1,p2) __attribute__((format(func,p1,p2))) Chris@87: #else Chris@87: #define Py_FORMAT_PARSETUPLE(func,p1,p2) Chris@87: #endif Chris@87: Chris@87: /* Chris@87: * Specify alignment on compilers that support it. Chris@87: */ Chris@87: #if defined(__GNUC__) && __GNUC__ >= 3 Chris@87: #define Py_ALIGNED(x) __attribute__((aligned(x))) Chris@87: #else Chris@87: #define Py_ALIGNED(x) Chris@87: #endif Chris@87: Chris@87: /* Eliminate end-of-loop code not reached warnings from SunPro C Chris@87: * when using do{...}while(0) macros Chris@87: */ Chris@87: #ifdef __SUNPRO_C Chris@87: #pragma error_messages (off,E_END_OF_LOOP_CODE_NOT_REACHED) Chris@87: #endif Chris@87: Chris@87: /* Chris@87: * Older Microsoft compilers don't support the C99 long long literal suffixes, Chris@87: * so these will be defined in PC/pyconfig.h for those compilers. Chris@87: */ Chris@87: #ifndef Py_LL Chris@87: #define Py_LL(x) x##LL Chris@87: #endif Chris@87: Chris@87: #ifndef Py_ULL Chris@87: #define Py_ULL(x) Py_LL(x##U) Chris@87: #endif Chris@87: Chris@87: #endif /* Py_PYPORT_H */