mirror of https://github.com/python/cpython
791 lines
28 KiB
C
791 lines
28 KiB
C
#ifndef Py_PYPORT_H
|
|
#define Py_PYPORT_H
|
|
|
|
#include "pyconfig.h" /* include for defines */
|
|
|
|
#include <inttypes.h>
|
|
|
|
/**************************************************************************
|
|
Symbols and macros to supply platform-independent interfaces to basic
|
|
C language & library operations whose spellings vary across platforms.
|
|
|
|
Please try to make documentation here as clear as possible: by definition,
|
|
the stuff here is trying to illuminate C's darkest corners.
|
|
|
|
Config #defines referenced here:
|
|
|
|
SIGNED_RIGHT_SHIFT_ZERO_FILLS
|
|
Meaning: To be defined iff i>>j does not extend the sign bit when i is a
|
|
signed integral type and i < 0.
|
|
Used in: Py_ARITHMETIC_RIGHT_SHIFT
|
|
|
|
Py_DEBUG
|
|
Meaning: Extra checks compiled in for debug mode.
|
|
Used in: Py_SAFE_DOWNCAST
|
|
|
|
**************************************************************************/
|
|
|
|
/* typedefs for some C9X-defined synonyms for integral types.
|
|
*
|
|
* The names in Python are exactly the same as the C9X names, except with a
|
|
* Py_ prefix. Until C9X is universally implemented, this is the only way
|
|
* to ensure that Python gets reliable names that don't conflict with names
|
|
* in non-Python code that are playing their own tricks to define the C9X
|
|
* names.
|
|
*
|
|
* NOTE: don't go nuts here! Python has no use for *most* of the C9X
|
|
* integral synonyms. Only define the ones we actually need.
|
|
*/
|
|
|
|
// long long is required. Ensure HAVE_LONG_LONG is defined for compatibility.
|
|
#ifndef HAVE_LONG_LONG
|
|
#define HAVE_LONG_LONG
|
|
#endif
|
|
#ifndef PY_LONG_LONG
|
|
#define PY_LONG_LONG long long
|
|
/* If LLONG_MAX is defined in limits.h, use that. */
|
|
#define PY_LLONG_MIN LLONG_MIN
|
|
#define PY_LLONG_MAX LLONG_MAX
|
|
#define PY_ULLONG_MAX ULLONG_MAX
|
|
#endif
|
|
|
|
#define PY_UINT32_T uint32_t
|
|
#define PY_UINT64_T uint64_t
|
|
|
|
/* Signed variants of the above */
|
|
#define PY_INT32_T int32_t
|
|
#define PY_INT64_T int64_t
|
|
|
|
/* If PYLONG_BITS_IN_DIGIT is not defined then we'll use 30-bit digits if all
|
|
the necessary integer types are available, and we're on a 64-bit platform
|
|
(as determined by SIZEOF_VOID_P); otherwise we use 15-bit digits. */
|
|
|
|
#ifndef PYLONG_BITS_IN_DIGIT
|
|
#if SIZEOF_VOID_P >= 8
|
|
#define PYLONG_BITS_IN_DIGIT 30
|
|
#else
|
|
#define PYLONG_BITS_IN_DIGIT 15
|
|
#endif
|
|
#endif
|
|
|
|
/* uintptr_t is the C9X name for an unsigned integral type such that a
|
|
* legitimate void* can be cast to uintptr_t and then back to void* again
|
|
* without loss of information. Similarly for intptr_t, wrt a signed
|
|
* integral type.
|
|
*/
|
|
typedef uintptr_t Py_uintptr_t;
|
|
typedef intptr_t Py_intptr_t;
|
|
|
|
/* Py_ssize_t is a signed integral type such that sizeof(Py_ssize_t) ==
|
|
* sizeof(size_t). C99 doesn't define such a thing directly (size_t is an
|
|
* unsigned integral type). See PEP 353 for details.
|
|
*/
|
|
#ifdef HAVE_SSIZE_T
|
|
typedef ssize_t Py_ssize_t;
|
|
#elif SIZEOF_VOID_P == SIZEOF_SIZE_T
|
|
typedef Py_intptr_t Py_ssize_t;
|
|
#else
|
|
# error "Python needs a typedef for Py_ssize_t in pyport.h."
|
|
#endif
|
|
|
|
/* Py_hash_t is the same size as a pointer. */
|
|
#define SIZEOF_PY_HASH_T SIZEOF_SIZE_T
|
|
typedef Py_ssize_t Py_hash_t;
|
|
/* Py_uhash_t is the unsigned equivalent needed to calculate numeric hash. */
|
|
#define SIZEOF_PY_UHASH_T SIZEOF_SIZE_T
|
|
typedef size_t Py_uhash_t;
|
|
|
|
/* Only used for compatibility with code that may not be PY_SSIZE_T_CLEAN. */
|
|
#ifdef PY_SSIZE_T_CLEAN
|
|
typedef Py_ssize_t Py_ssize_clean_t;
|
|
#else
|
|
typedef int Py_ssize_clean_t;
|
|
#endif
|
|
|
|
/* Largest possible value of size_t. */
|
|
#define PY_SIZE_MAX SIZE_MAX
|
|
|
|
/* Largest positive value of type Py_ssize_t. */
|
|
#define PY_SSIZE_T_MAX ((Py_ssize_t)(((size_t)-1)>>1))
|
|
/* Smallest negative value of type Py_ssize_t. */
|
|
#define PY_SSIZE_T_MIN (-PY_SSIZE_T_MAX-1)
|
|
|
|
/* PY_FORMAT_SIZE_T is a platform-specific modifier for use in a printf
|
|
* format to convert an argument with the width of a size_t or Py_ssize_t.
|
|
* C99 introduced "z" for this purpose, but not all platforms support that;
|
|
* e.g., MS compilers use "I" instead.
|
|
*
|
|
* These "high level" Python format functions interpret "z" correctly on
|
|
* all platforms (Python interprets the format string itself, and does whatever
|
|
* the platform C requires to convert a size_t/Py_ssize_t argument):
|
|
*
|
|
* PyBytes_FromFormat
|
|
* PyErr_Format
|
|
* PyBytes_FromFormatV
|
|
* PyUnicode_FromFormatV
|
|
*
|
|
* Lower-level uses require that you interpolate the correct format modifier
|
|
* yourself (e.g., calling printf, fprintf, sprintf, PyOS_snprintf); for
|
|
* example,
|
|
*
|
|
* Py_ssize_t index;
|
|
* fprintf(stderr, "index %" PY_FORMAT_SIZE_T "d sucks\n", index);
|
|
*
|
|
* That will expand to %ld, or %Id, or to something else correct for a
|
|
* Py_ssize_t on the platform.
|
|
*/
|
|
#ifndef PY_FORMAT_SIZE_T
|
|
# if SIZEOF_SIZE_T == SIZEOF_INT && !defined(__APPLE__)
|
|
# define PY_FORMAT_SIZE_T ""
|
|
# elif SIZEOF_SIZE_T == SIZEOF_LONG
|
|
# define PY_FORMAT_SIZE_T "l"
|
|
# elif defined(MS_WINDOWS)
|
|
# define PY_FORMAT_SIZE_T "I"
|
|
# else
|
|
# error "This platform's pyconfig.h needs to define PY_FORMAT_SIZE_T"
|
|
# endif
|
|
#endif
|
|
|
|
/* Py_LOCAL can be used instead of static to get the fastest possible calling
|
|
* convention for functions that are local to a given module.
|
|
*
|
|
* Py_LOCAL_INLINE does the same thing, and also explicitly requests inlining,
|
|
* for platforms that support that.
|
|
*
|
|
* If PY_LOCAL_AGGRESSIVE is defined before python.h is included, more
|
|
* "aggressive" inlining/optimization is enabled for the entire module. This
|
|
* may lead to code bloat, and may slow things down for those reasons. It may
|
|
* also lead to errors, if the code relies on pointer aliasing. Use with
|
|
* care.
|
|
*
|
|
* NOTE: You can only use this for functions that are entirely local to a
|
|
* module; functions that are exported via method tables, callbacks, etc,
|
|
* should keep using static.
|
|
*/
|
|
|
|
#if defined(_MSC_VER)
|
|
#if defined(PY_LOCAL_AGGRESSIVE)
|
|
/* enable more aggressive optimization for visual studio */
|
|
#pragma optimize("agtw", on)
|
|
#endif
|
|
/* ignore warnings if the compiler decides not to inline a function */
|
|
#pragma warning(disable: 4710)
|
|
/* fastest possible local call under MSVC */
|
|
#define Py_LOCAL(type) static type __fastcall
|
|
#define Py_LOCAL_INLINE(type) static __inline type __fastcall
|
|
#elif defined(USE_INLINE)
|
|
#define Py_LOCAL(type) static type
|
|
#define Py_LOCAL_INLINE(type) static inline type
|
|
#else
|
|
#define Py_LOCAL(type) static type
|
|
#define Py_LOCAL_INLINE(type) static type
|
|
#endif
|
|
|
|
/* Py_MEMCPY is kept for backwards compatibility,
|
|
* see https://bugs.python.org/issue28126 */
|
|
#define Py_MEMCPY memcpy
|
|
|
|
#include <stdlib.h>
|
|
|
|
#ifdef HAVE_IEEEFP_H
|
|
#include <ieeefp.h> /* needed for 'finite' declaration on some platforms */
|
|
#endif
|
|
|
|
#include <math.h> /* Moved here from the math section, before extern "C" */
|
|
|
|
/********************************************
|
|
* WRAPPER FOR <time.h> and/or <sys/time.h> *
|
|
********************************************/
|
|
|
|
#ifdef TIME_WITH_SYS_TIME
|
|
#include <sys/time.h>
|
|
#include <time.h>
|
|
#else /* !TIME_WITH_SYS_TIME */
|
|
#ifdef HAVE_SYS_TIME_H
|
|
#include <sys/time.h>
|
|
#else /* !HAVE_SYS_TIME_H */
|
|
#include <time.h>
|
|
#endif /* !HAVE_SYS_TIME_H */
|
|
#endif /* !TIME_WITH_SYS_TIME */
|
|
|
|
|
|
/******************************
|
|
* WRAPPER FOR <sys/select.h> *
|
|
******************************/
|
|
|
|
/* NB caller must include <sys/types.h> */
|
|
|
|
#ifdef HAVE_SYS_SELECT_H
|
|
#include <sys/select.h>
|
|
#endif /* !HAVE_SYS_SELECT_H */
|
|
|
|
/*******************************
|
|
* stat() and fstat() fiddling *
|
|
*******************************/
|
|
|
|
#ifdef HAVE_SYS_STAT_H
|
|
#include <sys/stat.h>
|
|
#elif defined(HAVE_STAT_H)
|
|
#include <stat.h>
|
|
#endif
|
|
|
|
#ifndef S_IFMT
|
|
/* VisualAge C/C++ Failed to Define MountType Field in sys/stat.h */
|
|
#define S_IFMT 0170000
|
|
#endif
|
|
|
|
#ifndef S_IFLNK
|
|
/* Windows doesn't define S_IFLNK but posixmodule.c maps
|
|
* IO_REPARSE_TAG_SYMLINK to S_IFLNK */
|
|
# define S_IFLNK 0120000
|
|
#endif
|
|
|
|
#ifndef S_ISREG
|
|
#define S_ISREG(x) (((x) & S_IFMT) == S_IFREG)
|
|
#endif
|
|
|
|
#ifndef S_ISDIR
|
|
#define S_ISDIR(x) (((x) & S_IFMT) == S_IFDIR)
|
|
#endif
|
|
|
|
#ifndef S_ISCHR
|
|
#define S_ISCHR(x) (((x) & S_IFMT) == S_IFCHR)
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
/* Move this down here since some C++ #include's don't like to be included
|
|
inside an extern "C" */
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/* Py_ARITHMETIC_RIGHT_SHIFT
|
|
* C doesn't define whether a right-shift of a signed integer sign-extends
|
|
* or zero-fills. Here a macro to force sign extension:
|
|
* Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J)
|
|
* Return I >> J, forcing sign extension. Arithmetically, return the
|
|
* floor of I/2**J.
|
|
* Requirements:
|
|
* I should have signed integer type. In the terminology of C99, this can
|
|
* be either one of the five standard signed integer types (signed char,
|
|
* short, int, long, long long) or an extended signed integer type.
|
|
* J is an integer >= 0 and strictly less than the number of bits in the
|
|
* type of I (because C doesn't define what happens for J outside that
|
|
* range either).
|
|
* TYPE used to specify the type of I, but is now ignored. It's been left
|
|
* in for backwards compatibility with versions <= 2.6 or 3.0.
|
|
* Caution:
|
|
* I may be evaluated more than once.
|
|
*/
|
|
#ifdef SIGNED_RIGHT_SHIFT_ZERO_FILLS
|
|
#define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) \
|
|
((I) < 0 ? -1-((-1-(I)) >> (J)) : (I) >> (J))
|
|
#else
|
|
#define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) ((I) >> (J))
|
|
#endif
|
|
|
|
/* Py_FORCE_EXPANSION(X)
|
|
* "Simply" returns its argument. However, macro expansions within the
|
|
* argument are evaluated. This unfortunate trickery is needed to get
|
|
* token-pasting to work as desired in some cases.
|
|
*/
|
|
#define Py_FORCE_EXPANSION(X) X
|
|
|
|
/* Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW)
|
|
* Cast VALUE to type NARROW from type WIDE. In Py_DEBUG mode, this
|
|
* assert-fails if any information is lost.
|
|
* Caution:
|
|
* VALUE may be evaluated more than once.
|
|
*/
|
|
#ifdef Py_DEBUG
|
|
#define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) \
|
|
(assert((WIDE)(NARROW)(VALUE) == (VALUE)), (NARROW)(VALUE))
|
|
#else
|
|
#define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) (NARROW)(VALUE)
|
|
#endif
|
|
|
|
/* Py_SET_ERRNO_ON_MATH_ERROR(x)
|
|
* If a libm function did not set errno, but it looks like the result
|
|
* overflowed or not-a-number, set errno to ERANGE or EDOM. Set errno
|
|
* to 0 before calling a libm function, and invoke this macro after,
|
|
* passing the function result.
|
|
* Caution:
|
|
* This isn't reliable. See Py_OVERFLOWED comments.
|
|
* X is evaluated more than once.
|
|
*/
|
|
#if defined(__FreeBSD__) || defined(__OpenBSD__) || (defined(__hpux) && defined(__ia64))
|
|
#define _Py_SET_EDOM_FOR_NAN(X) if (isnan(X)) errno = EDOM;
|
|
#else
|
|
#define _Py_SET_EDOM_FOR_NAN(X) ;
|
|
#endif
|
|
#define Py_SET_ERRNO_ON_MATH_ERROR(X) \
|
|
do { \
|
|
if (errno == 0) { \
|
|
if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL) \
|
|
errno = ERANGE; \
|
|
else _Py_SET_EDOM_FOR_NAN(X) \
|
|
} \
|
|
} while(0)
|
|
|
|
/* Py_SET_ERANGE_ON_OVERFLOW(x)
|
|
* An alias of Py_SET_ERRNO_ON_MATH_ERROR for backward-compatibility.
|
|
*/
|
|
#define Py_SET_ERANGE_IF_OVERFLOW(X) Py_SET_ERRNO_ON_MATH_ERROR(X)
|
|
|
|
/* Py_ADJUST_ERANGE1(x)
|
|
* Py_ADJUST_ERANGE2(x, y)
|
|
* Set errno to 0 before calling a libm function, and invoke one of these
|
|
* macros after, passing the function result(s) (Py_ADJUST_ERANGE2 is useful
|
|
* for functions returning complex results). This makes two kinds of
|
|
* adjustments to errno: (A) If it looks like the platform libm set
|
|
* errno=ERANGE due to underflow, clear errno. (B) If it looks like the
|
|
* platform libm overflowed but didn't set errno, force errno to ERANGE. In
|
|
* effect, we're trying to force a useful implementation of C89 errno
|
|
* behavior.
|
|
* Caution:
|
|
* This isn't reliable. See Py_OVERFLOWED comments.
|
|
* X and Y may be evaluated more than once.
|
|
*/
|
|
#define Py_ADJUST_ERANGE1(X) \
|
|
do { \
|
|
if (errno == 0) { \
|
|
if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL) \
|
|
errno = ERANGE; \
|
|
} \
|
|
else if (errno == ERANGE && (X) == 0.0) \
|
|
errno = 0; \
|
|
} while(0)
|
|
|
|
#define Py_ADJUST_ERANGE2(X, Y) \
|
|
do { \
|
|
if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL || \
|
|
(Y) == Py_HUGE_VAL || (Y) == -Py_HUGE_VAL) { \
|
|
if (errno == 0) \
|
|
errno = ERANGE; \
|
|
} \
|
|
else if (errno == ERANGE) \
|
|
errno = 0; \
|
|
} while(0)
|
|
|
|
/* The functions _Py_dg_strtod and _Py_dg_dtoa in Python/dtoa.c (which are
|
|
* required to support the short float repr introduced in Python 3.1) require
|
|
* that the floating-point unit that's being used for arithmetic operations
|
|
* on C doubles is set to use 53-bit precision. It also requires that the
|
|
* FPU rounding mode is round-half-to-even, but that's less often an issue.
|
|
*
|
|
* If your FPU isn't already set to 53-bit precision/round-half-to-even, and
|
|
* you want to make use of _Py_dg_strtod and _Py_dg_dtoa, then you should
|
|
*
|
|
* #define HAVE_PY_SET_53BIT_PRECISION 1
|
|
*
|
|
* and also give appropriate definitions for the following three macros:
|
|
*
|
|
* _PY_SET_53BIT_PRECISION_START : store original FPU settings, and
|
|
* set FPU to 53-bit precision/round-half-to-even
|
|
* _PY_SET_53BIT_PRECISION_END : restore original FPU settings
|
|
* _PY_SET_53BIT_PRECISION_HEADER : any variable declarations needed to
|
|
* use the two macros above.
|
|
*
|
|
* The macros are designed to be used within a single C function: see
|
|
* Python/pystrtod.c for an example of their use.
|
|
*/
|
|
|
|
/* get and set x87 control word for gcc/x86 */
|
|
#ifdef HAVE_GCC_ASM_FOR_X87
|
|
#define HAVE_PY_SET_53BIT_PRECISION 1
|
|
/* _Py_get/set_387controlword functions are defined in Python/pymath.c */
|
|
#define _Py_SET_53BIT_PRECISION_HEADER \
|
|
unsigned short old_387controlword, new_387controlword
|
|
#define _Py_SET_53BIT_PRECISION_START \
|
|
do { \
|
|
old_387controlword = _Py_get_387controlword(); \
|
|
new_387controlword = (old_387controlword & ~0x0f00) | 0x0200; \
|
|
if (new_387controlword != old_387controlword) \
|
|
_Py_set_387controlword(new_387controlword); \
|
|
} while (0)
|
|
#define _Py_SET_53BIT_PRECISION_END \
|
|
if (new_387controlword != old_387controlword) \
|
|
_Py_set_387controlword(old_387controlword)
|
|
#endif
|
|
|
|
/* get and set x87 control word for VisualStudio/x86 */
|
|
#if defined(_MSC_VER) && !defined(_WIN64) /* x87 not supported in 64-bit */
|
|
#define HAVE_PY_SET_53BIT_PRECISION 1
|
|
#define _Py_SET_53BIT_PRECISION_HEADER \
|
|
unsigned int old_387controlword, new_387controlword, out_387controlword
|
|
/* We use the __control87_2 function to set only the x87 control word.
|
|
The SSE control word is unaffected. */
|
|
#define _Py_SET_53BIT_PRECISION_START \
|
|
do { \
|
|
__control87_2(0, 0, &old_387controlword, NULL); \
|
|
new_387controlword = \
|
|
(old_387controlword & ~(_MCW_PC | _MCW_RC)) | (_PC_53 | _RC_NEAR); \
|
|
if (new_387controlword != old_387controlword) \
|
|
__control87_2(new_387controlword, _MCW_PC | _MCW_RC, \
|
|
&out_387controlword, NULL); \
|
|
} while (0)
|
|
#define _Py_SET_53BIT_PRECISION_END \
|
|
do { \
|
|
if (new_387controlword != old_387controlword) \
|
|
__control87_2(old_387controlword, _MCW_PC | _MCW_RC, \
|
|
&out_387controlword, NULL); \
|
|
} while (0)
|
|
#endif
|
|
|
|
#ifdef HAVE_GCC_ASM_FOR_MC68881
|
|
#define HAVE_PY_SET_53BIT_PRECISION 1
|
|
#define _Py_SET_53BIT_PRECISION_HEADER \
|
|
unsigned int old_fpcr, new_fpcr
|
|
#define _Py_SET_53BIT_PRECISION_START \
|
|
do { \
|
|
__asm__ ("fmove.l %%fpcr,%0" : "=g" (old_fpcr)); \
|
|
/* Set double precision / round to nearest. */ \
|
|
new_fpcr = (old_fpcr & ~0xf0) | 0x80; \
|
|
if (new_fpcr != old_fpcr) \
|
|
__asm__ volatile ("fmove.l %0,%%fpcr" : : "g" (new_fpcr)); \
|
|
} while (0)
|
|
#define _Py_SET_53BIT_PRECISION_END \
|
|
do { \
|
|
if (new_fpcr != old_fpcr) \
|
|
__asm__ volatile ("fmove.l %0,%%fpcr" : : "g" (old_fpcr)); \
|
|
} while (0)
|
|
#endif
|
|
|
|
/* default definitions are empty */
|
|
#ifndef HAVE_PY_SET_53BIT_PRECISION
|
|
#define _Py_SET_53BIT_PRECISION_HEADER
|
|
#define _Py_SET_53BIT_PRECISION_START
|
|
#define _Py_SET_53BIT_PRECISION_END
|
|
#endif
|
|
|
|
/* If we can't guarantee 53-bit precision, don't use the code
|
|
in Python/dtoa.c, but fall back to standard code. This
|
|
means that repr of a float will be long (17 sig digits).
|
|
|
|
Realistically, there are two things that could go wrong:
|
|
|
|
(1) doubles aren't IEEE 754 doubles, or
|
|
(2) we're on x86 with the rounding precision set to 64-bits
|
|
(extended precision), and we don't know how to change
|
|
the rounding precision.
|
|
*/
|
|
|
|
#if !defined(DOUBLE_IS_LITTLE_ENDIAN_IEEE754) && \
|
|
!defined(DOUBLE_IS_BIG_ENDIAN_IEEE754) && \
|
|
!defined(DOUBLE_IS_ARM_MIXED_ENDIAN_IEEE754)
|
|
#define PY_NO_SHORT_FLOAT_REPR
|
|
#endif
|
|
|
|
/* double rounding is symptomatic of use of extended precision on x86. If
|
|
we're seeing double rounding, and we don't have any mechanism available for
|
|
changing the FPU rounding precision, then don't use Python/dtoa.c. */
|
|
#if defined(X87_DOUBLE_ROUNDING) && !defined(HAVE_PY_SET_53BIT_PRECISION)
|
|
#define PY_NO_SHORT_FLOAT_REPR
|
|
#endif
|
|
|
|
|
|
/* Py_DEPRECATED(version)
|
|
* Declare a variable, type, or function deprecated.
|
|
* Usage:
|
|
* extern int old_var Py_DEPRECATED(2.3);
|
|
* typedef int T1 Py_DEPRECATED(2.4);
|
|
* extern int x() Py_DEPRECATED(2.5);
|
|
*/
|
|
#if defined(__GNUC__) \
|
|
&& ((__GNUC__ >= 4) || (__GNUC__ == 3) && (__GNUC_MINOR__ >= 1))
|
|
#define Py_DEPRECATED(VERSION_UNUSED) __attribute__((__deprecated__))
|
|
#else
|
|
#define Py_DEPRECATED(VERSION_UNUSED)
|
|
#endif
|
|
|
|
|
|
/* _Py_HOT_FUNCTION
|
|
* The hot attribute on a function is used to inform the compiler that the
|
|
* function is a hot spot of the compiled program. The function is optimized
|
|
* more aggressively and on many target it is placed into special subsection of
|
|
* the text section so all hot functions appears close together improving
|
|
* locality.
|
|
*
|
|
* Usage:
|
|
* int _Py_HOT_FUNCTION x() { return 3; }
|
|
*
|
|
* Issue #28618: This attribute must not be abused, otherwise it can have a
|
|
* negative effect on performance. Only the functions were Python spend most of
|
|
* its time must use it. Use a profiler when running performance benchmark
|
|
* suite to find these functions.
|
|
*/
|
|
#if defined(__GNUC__) \
|
|
&& ((__GNUC__ >= 5) || (__GNUC__ == 4) && (__GNUC_MINOR__ >= 3))
|
|
#define _Py_HOT_FUNCTION __attribute__((hot))
|
|
#else
|
|
#define _Py_HOT_FUNCTION
|
|
#endif
|
|
|
|
/**************************************************************************
|
|
Prototypes that are missing from the standard include files on some systems
|
|
(and possibly only some versions of such systems.)
|
|
|
|
Please be conservative with adding new ones, document them and enclose them
|
|
in platform-specific #ifdefs.
|
|
**************************************************************************/
|
|
|
|
#ifdef SOLARIS
|
|
/* Unchecked */
|
|
extern int gethostname(char *, int);
|
|
#endif
|
|
|
|
#ifdef HAVE__GETPTY
|
|
#include <sys/types.h> /* we need to import mode_t */
|
|
extern char * _getpty(int *, int, mode_t, int);
|
|
#endif
|
|
|
|
/* On QNX 6, struct termio must be declared by including sys/termio.h
|
|
if TCGETA, TCSETA, TCSETAW, or TCSETAF are used. sys/termio.h must
|
|
be included before termios.h or it will generate an error. */
|
|
#if defined(HAVE_SYS_TERMIO_H) && !defined(__hpux)
|
|
#include <sys/termio.h>
|
|
#endif
|
|
|
|
#if defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY)
|
|
#if !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H)
|
|
/* BSDI does not supply a prototype for the 'openpty' and 'forkpty'
|
|
functions, even though they are included in libutil. */
|
|
#include <termios.h>
|
|
extern int openpty(int *, int *, char *, struct termios *, struct winsize *);
|
|
extern pid_t forkpty(int *, char *, struct termios *, struct winsize *);
|
|
#endif /* !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H) */
|
|
#endif /* defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) */
|
|
|
|
|
|
/* On 4.4BSD-descendants, ctype functions serves the whole range of
|
|
* wchar_t character set rather than single byte code points only.
|
|
* This characteristic can break some operations of string object
|
|
* including str.upper() and str.split() on UTF-8 locales. This
|
|
* workaround was provided by Tim Robbins of FreeBSD project.
|
|
*/
|
|
|
|
#ifdef __FreeBSD__
|
|
#include <osreldate.h>
|
|
#if (__FreeBSD_version >= 500040 && __FreeBSD_version < 602113) || \
|
|
(__FreeBSD_version >= 700000 && __FreeBSD_version < 700054) || \
|
|
(__FreeBSD_version >= 800000 && __FreeBSD_version < 800001)
|
|
# define _PY_PORT_CTYPE_UTF8_ISSUE
|
|
#endif
|
|
#endif
|
|
|
|
|
|
#if defined(__APPLE__)
|
|
# define _PY_PORT_CTYPE_UTF8_ISSUE
|
|
#endif
|
|
|
|
#ifdef _PY_PORT_CTYPE_UTF8_ISSUE
|
|
#ifndef __cplusplus
|
|
/* The workaround below is unsafe in C++ because
|
|
* the <locale> defines these symbols as real functions,
|
|
* with a slightly different signature.
|
|
* See issue #10910
|
|
*/
|
|
#include <ctype.h>
|
|
#include <wctype.h>
|
|
#undef isalnum
|
|
#define isalnum(c) iswalnum(btowc(c))
|
|
#undef isalpha
|
|
#define isalpha(c) iswalpha(btowc(c))
|
|
#undef islower
|
|
#define islower(c) iswlower(btowc(c))
|
|
#undef isspace
|
|
#define isspace(c) iswspace(btowc(c))
|
|
#undef isupper
|
|
#define isupper(c) iswupper(btowc(c))
|
|
#undef tolower
|
|
#define tolower(c) towlower(btowc(c))
|
|
#undef toupper
|
|
#define toupper(c) towupper(btowc(c))
|
|
#endif
|
|
#endif
|
|
|
|
|
|
/* Declarations for symbol visibility.
|
|
|
|
PyAPI_FUNC(type): Declares a public Python API function and return type
|
|
PyAPI_DATA(type): Declares public Python data and its type
|
|
PyMODINIT_FUNC: A Python module init function. If these functions are
|
|
inside the Python core, they are private to the core.
|
|
If in an extension module, it may be declared with
|
|
external linkage depending on the platform.
|
|
|
|
As a number of platforms support/require "__declspec(dllimport/dllexport)",
|
|
we support a HAVE_DECLSPEC_DLL macro to save duplication.
|
|
*/
|
|
|
|
/*
|
|
All windows ports, except cygwin, are handled in PC/pyconfig.h.
|
|
|
|
Cygwin is the only other autoconf platform requiring special
|
|
linkage handling and it uses __declspec().
|
|
*/
|
|
#if defined(__CYGWIN__)
|
|
# define HAVE_DECLSPEC_DLL
|
|
#endif
|
|
|
|
/* only get special linkage if built as shared or platform is Cygwin */
|
|
#if defined(Py_ENABLE_SHARED) || defined(__CYGWIN__)
|
|
# if defined(HAVE_DECLSPEC_DLL)
|
|
# ifdef Py_BUILD_CORE
|
|
# define PyAPI_FUNC(RTYPE) __declspec(dllexport) RTYPE
|
|
# define PyAPI_DATA(RTYPE) extern __declspec(dllexport) RTYPE
|
|
/* module init functions inside the core need no external linkage */
|
|
/* except for Cygwin to handle embedding */
|
|
# if defined(__CYGWIN__)
|
|
# define PyMODINIT_FUNC __declspec(dllexport) PyObject*
|
|
# else /* __CYGWIN__ */
|
|
# define PyMODINIT_FUNC PyObject*
|
|
# endif /* __CYGWIN__ */
|
|
# else /* Py_BUILD_CORE */
|
|
/* Building an extension module, or an embedded situation */
|
|
/* public Python functions and data are imported */
|
|
/* Under Cygwin, auto-import functions to prevent compilation */
|
|
/* failures similar to those described at the bottom of 4.1: */
|
|
/* http://docs.python.org/extending/windows.html#a-cookbook-approach */
|
|
# if !defined(__CYGWIN__)
|
|
# define PyAPI_FUNC(RTYPE) __declspec(dllimport) RTYPE
|
|
# endif /* !__CYGWIN__ */
|
|
# define PyAPI_DATA(RTYPE) extern __declspec(dllimport) RTYPE
|
|
/* module init functions outside the core must be exported */
|
|
# if defined(__cplusplus)
|
|
# define PyMODINIT_FUNC extern "C" __declspec(dllexport) PyObject*
|
|
# else /* __cplusplus */
|
|
# define PyMODINIT_FUNC __declspec(dllexport) PyObject*
|
|
# endif /* __cplusplus */
|
|
# endif /* Py_BUILD_CORE */
|
|
# endif /* HAVE_DECLSPEC */
|
|
#endif /* Py_ENABLE_SHARED */
|
|
|
|
/* If no external linkage macros defined by now, create defaults */
|
|
#ifndef PyAPI_FUNC
|
|
# define PyAPI_FUNC(RTYPE) RTYPE
|
|
#endif
|
|
#ifndef PyAPI_DATA
|
|
# define PyAPI_DATA(RTYPE) extern RTYPE
|
|
#endif
|
|
#ifndef PyMODINIT_FUNC
|
|
# if defined(__cplusplus)
|
|
# define PyMODINIT_FUNC extern "C" PyObject*
|
|
# else /* __cplusplus */
|
|
# define PyMODINIT_FUNC PyObject*
|
|
# endif /* __cplusplus */
|
|
#endif
|
|
|
|
/* limits.h constants that may be missing */
|
|
|
|
#ifndef INT_MAX
|
|
#define INT_MAX 2147483647
|
|
#endif
|
|
|
|
#ifndef LONG_MAX
|
|
#if SIZEOF_LONG == 4
|
|
#define LONG_MAX 0X7FFFFFFFL
|
|
#elif SIZEOF_LONG == 8
|
|
#define LONG_MAX 0X7FFFFFFFFFFFFFFFL
|
|
#else
|
|
#error "could not set LONG_MAX in pyport.h"
|
|
#endif
|
|
#endif
|
|
|
|
#ifndef LONG_MIN
|
|
#define LONG_MIN (-LONG_MAX-1)
|
|
#endif
|
|
|
|
#ifndef LONG_BIT
|
|
#define LONG_BIT (8 * SIZEOF_LONG)
|
|
#endif
|
|
|
|
#if LONG_BIT != 8 * SIZEOF_LONG
|
|
/* 04-Oct-2000 LONG_BIT is apparently (mis)defined as 64 on some recent
|
|
* 32-bit platforms using gcc. We try to catch that here at compile-time
|
|
* rather than waiting for integer multiplication to trigger bogus
|
|
* overflows.
|
|
*/
|
|
#error "LONG_BIT definition appears wrong for platform (bad gcc/glibc config?)."
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/*
|
|
* Hide GCC attributes from compilers that don't support them.
|
|
*/
|
|
#if (!defined(__GNUC__) || __GNUC__ < 2 || \
|
|
(__GNUC__ == 2 && __GNUC_MINOR__ < 7) )
|
|
#define Py_GCC_ATTRIBUTE(x)
|
|
#else
|
|
#define Py_GCC_ATTRIBUTE(x) __attribute__(x)
|
|
#endif
|
|
|
|
/*
|
|
* Specify alignment on compilers that support it.
|
|
*/
|
|
#if defined(__GNUC__) && __GNUC__ >= 3
|
|
#define Py_ALIGNED(x) __attribute__((aligned(x)))
|
|
#else
|
|
#define Py_ALIGNED(x)
|
|
#endif
|
|
|
|
/* Eliminate end-of-loop code not reached warnings from SunPro C
|
|
* when using do{...}while(0) macros
|
|
*/
|
|
#ifdef __SUNPRO_C
|
|
#pragma error_messages (off,E_END_OF_LOOP_CODE_NOT_REACHED)
|
|
#endif
|
|
|
|
#ifndef Py_LL
|
|
#define Py_LL(x) x##LL
|
|
#endif
|
|
|
|
#ifndef Py_ULL
|
|
#define Py_ULL(x) Py_LL(x##U)
|
|
#endif
|
|
|
|
#define Py_VA_COPY va_copy
|
|
|
|
/*
|
|
* Convenient macros to deal with endianness of the platform. WORDS_BIGENDIAN is
|
|
* detected by configure and defined in pyconfig.h. The code in pyconfig.h
|
|
* also takes care of Apple's universal builds.
|
|
*/
|
|
|
|
#ifdef WORDS_BIGENDIAN
|
|
#define PY_BIG_ENDIAN 1
|
|
#define PY_LITTLE_ENDIAN 0
|
|
#else
|
|
#define PY_BIG_ENDIAN 0
|
|
#define PY_LITTLE_ENDIAN 1
|
|
#endif
|
|
|
|
#ifdef Py_BUILD_CORE
|
|
/*
|
|
* Macros to protect CRT calls against instant termination when passed an
|
|
* invalid parameter (issue23524).
|
|
*/
|
|
#if defined _MSC_VER && _MSC_VER >= 1900
|
|
|
|
extern _invalid_parameter_handler _Py_silent_invalid_parameter_handler;
|
|
#define _Py_BEGIN_SUPPRESS_IPH { _invalid_parameter_handler _Py_old_handler = \
|
|
_set_thread_local_invalid_parameter_handler(_Py_silent_invalid_parameter_handler);
|
|
#define _Py_END_SUPPRESS_IPH _set_thread_local_invalid_parameter_handler(_Py_old_handler); }
|
|
|
|
#else
|
|
|
|
#define _Py_BEGIN_SUPPRESS_IPH
|
|
#define _Py_END_SUPPRESS_IPH
|
|
|
|
#endif /* _MSC_VER >= 1900 */
|
|
#endif /* Py_BUILD_CORE */
|
|
|
|
#ifdef __ANDROID__
|
|
#include <android/api-level.h>
|
|
#endif
|
|
|
|
#endif /* Py_PYPORT_H */
|