123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878 |
- #ifndef Py_PYPORT_H
- #define Py_PYPORT_H
- #include "pyconfig.h" /* include for defines */
- #include <inttypes.h>
- /* Defines to build Python and its standard library:
- *
- * - Py_BUILD_CORE: Build Python core. Give access to Python internals, but
- * should not be used by third-party modules.
- * - Py_BUILD_CORE_BUILTIN: Build a Python stdlib module as a built-in module.
- * - Py_BUILD_CORE_MODULE: Build a Python stdlib module as a dynamic library.
- *
- * Py_BUILD_CORE_BUILTIN and Py_BUILD_CORE_MODULE imply Py_BUILD_CORE.
- *
- * On Windows, Py_BUILD_CORE_MODULE exports "PyInit_xxx" symbol, whereas
- * Py_BUILD_CORE_BUILTIN does not.
- */
- #if defined(Py_BUILD_CORE_BUILTIN) && !defined(Py_BUILD_CORE)
- # define Py_BUILD_CORE
- #endif
- #if defined(Py_BUILD_CORE_MODULE) && !defined(Py_BUILD_CORE)
- # define Py_BUILD_CORE
- #endif
- /**************************************************************************
- 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 1
- #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 old MSVCs had not supported it.
- * Since MSVC supports "z" since (at least) 2015, we can just use "z"
- * for new code.
- *
- * 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 %zd or to something else correct for a Py_ssize_t on
- * the platform.
- */
- #ifndef PY_FORMAT_SIZE_T
- # define PY_FORMAT_SIZE_T "z"
- #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
- #else
- # define Py_LOCAL(type) static type
- # define Py_LOCAL_INLINE(type) static inline 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_IF_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) && !defined(_M_ARM) /* x87 not supported in 64-bit or ARM */
- #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.
- * The macro must be placed before the declaration.
- * Usage:
- * Py_DEPRECATED(3.3) extern int old_var;
- * Py_DEPRECATED(3.4) typedef int T1;
- * Py_DEPRECATED(3.8) PyAPI_FUNC(int) Py_OldFunction(void);
- */
- #if defined(__GNUC__) \
- && ((__GNUC__ >= 4) || (__GNUC__ == 3) && (__GNUC_MINOR__ >= 1))
- #define Py_DEPRECATED(VERSION_UNUSED) __attribute__((__deprecated__))
- #elif defined(_MSC_VER)
- #define Py_DEPRECATED(VERSION) __declspec(deprecated( \
- "deprecated in " #VERSION))
- #else
- #define Py_DEPRECATED(VERSION_UNUSED)
- #endif
- #if defined(__clang__)
- #define _Py_COMP_DIAG_PUSH _Pragma("clang diagnostic push")
- #define _Py_COMP_DIAG_IGNORE_DEPR_DECLS \
- _Pragma("clang diagnostic ignored \"-Wdeprecated-declarations\"")
- #define _Py_COMP_DIAG_POP _Pragma("clang diagnostic pop")
- #elif defined(__GNUC__) \
- && ((__GNUC__ >= 5) || (__GNUC__ == 4) && (__GNUC_MINOR__ >= 6))
- #define _Py_COMP_DIAG_PUSH _Pragma("GCC diagnostic push")
- #define _Py_COMP_DIAG_IGNORE_DEPR_DECLS \
- _Pragma("GCC diagnostic ignored \"-Wdeprecated-declarations\"")
- #define _Py_COMP_DIAG_POP _Pragma("GCC diagnostic pop")
- #elif defined(_MSC_VER)
- #define _Py_COMP_DIAG_PUSH __pragma(warning(push))
- #define _Py_COMP_DIAG_IGNORE_DEPR_DECLS __pragma(warning(disable: 4996))
- #define _Py_COMP_DIAG_POP __pragma(warning(pop))
- #else
- #define _Py_COMP_DIAG_PUSH
- #define _Py_COMP_DIAG_IGNORE_DEPR_DECLS
- #define _Py_COMP_DIAG_POP
- #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(void) { 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
- /* _Py_NO_INLINE
- * Disable inlining on a function. For example, it helps to reduce the C stack
- * consumption.
- *
- * Usage:
- * int _Py_NO_INLINE x(void) { return 3; }
- */
- #if defined(_MSC_VER)
- # define _Py_NO_INLINE __declspec(noinline)
- #elif defined(__GNUC__) || defined(__clang__)
- # define _Py_NO_INLINE __attribute__ ((noinline))
- #else
- # define _Py_NO_INLINE
- #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
- /* 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.
- */
- #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
- #include "exports.h"
- /* only get special linkage if built as shared or platform is Cygwin */
- #if defined(Py_ENABLE_SHARED) || defined(__CYGWIN__)
- # if defined(HAVE_DECLSPEC_DLL)
- # if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
- # define PyAPI_FUNC(RTYPE) Py_EXPORTED_SYMBOL RTYPE
- # define PyAPI_DATA(RTYPE) extern Py_EXPORTED_SYMBOL RTYPE
- /* module init functions inside the core need no external linkage */
- /* except for Cygwin to handle embedding */
- # if defined(__CYGWIN__)
- # define PyMODINIT_FUNC Py_EXPORTED_SYMBOL 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) Py_IMPORTED_SYMBOL RTYPE
- # endif /* !__CYGWIN__ */
- # define PyAPI_DATA(RTYPE) extern Py_IMPORTED_SYMBOL RTYPE
- /* module init functions outside the core must be exported */
- # if defined(__cplusplus)
- # define PyMODINIT_FUNC extern "C" Py_EXPORTED_SYMBOL PyObject*
- # else /* __cplusplus */
- # define PyMODINIT_FUNC Py_EXPORTED_SYMBOL PyObject*
- # endif /* __cplusplus */
- # endif /* Py_BUILD_CORE */
- # endif /* HAVE_DECLSPEC_DLL */
- #endif /* Py_ENABLE_SHARED */
- /* If no external linkage macros defined by now, create defaults */
- #ifndef PyAPI_FUNC
- # define PyAPI_FUNC(RTYPE) Py_EXPORTED_SYMBOL RTYPE
- #endif
- #ifndef PyAPI_DATA
- # define PyAPI_DATA(RTYPE) extern Py_EXPORTED_SYMBOL RTYPE
- #endif
- #ifndef PyMODINIT_FUNC
- # if defined(__cplusplus)
- # define PyMODINIT_FUNC extern "C" Py_EXPORTED_SYMBOL PyObject*
- # else /* __cplusplus */
- # define PyMODINIT_FUNC Py_EXPORTED_SYMBOL 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__
- /* The Android langinfo.h header is not used. */
- # undef HAVE_LANGINFO_H
- # undef CODESET
- #endif
- /* Maximum value of the Windows DWORD type */
- #define PY_DWORD_MAX 4294967295U
- /* This macro used to tell whether Python was built with multithreading
- * enabled. Now multithreading is always enabled, but keep the macro
- * for compatibility.
- */
- #ifndef WITH_THREAD
- # define WITH_THREAD
- #endif
- /* Check that ALT_SOABI is consistent with Py_TRACE_REFS:
- ./configure --with-trace-refs should must be used to define Py_TRACE_REFS */
- #if defined(ALT_SOABI) && defined(Py_TRACE_REFS)
- # error "Py_TRACE_REFS ABI is not compatible with release and debug ABI"
- #endif
- #if defined(__ANDROID__) || defined(__VXWORKS__)
- /* Ignore the locale encoding: force UTF-8 */
- # define _Py_FORCE_UTF8_LOCALE
- #endif
- #if defined(_Py_FORCE_UTF8_LOCALE) || defined(__APPLE__)
- /* Use UTF-8 as filesystem encoding */
- # define _Py_FORCE_UTF8_FS_ENCODING
- #endif
- /* Mark a function which cannot return. Example:
- PyAPI_FUNC(void) _Py_NO_RETURN PyThread_exit_thread(void);
- XLC support is intentionally omitted due to bpo-40244 */
- #if defined(__clang__) || \
- (defined(__GNUC__) && \
- ((__GNUC__ >= 3) || \
- (__GNUC__ == 2) && (__GNUC_MINOR__ >= 5)))
- # define _Py_NO_RETURN __attribute__((__noreturn__))
- #elif defined(_MSC_VER)
- # define _Py_NO_RETURN __declspec(noreturn)
- #else
- # define _Py_NO_RETURN
- #endif
- // Preprocessor check for a builtin preprocessor function. Always return 0
- // if __has_builtin() macro is not defined.
- //
- // __has_builtin() is available on clang and GCC 10.
- #ifdef __has_builtin
- # define _Py__has_builtin(x) __has_builtin(x)
- #else
- # define _Py__has_builtin(x) 0
- #endif
- #endif /* Py_PYPORT_H */
|