modsupport.h 4.78 KB
Newer Older
1

2 3 4 5 6 7
#ifndef Py_MODSUPPORT_H
#define Py_MODSUPPORT_H
#ifdef __cplusplus
extern "C" {
#endif

Guido van Rossum's avatar
Guido van Rossum committed
8 9
/* Module support interface */

10
#include <stdarg.h>
11

Martin v. Löwis's avatar
Martin v. Löwis committed
12 13 14 15 16 17 18 19
/* If PY_SSIZE_T_CLEAN is defined, each functions treats #-specifier
   to mean Py_ssize_t */
#ifdef PY_SSIZE_T_CLEAN
#define PyArg_Parse			_PyArg_Parse_SizeT
#define PyArg_ParseTuple		_PyArg_ParseTuple_SizeT
#define PyArg_ParseTupleAndKeywords	_PyArg_ParseTupleAndKeywords_SizeT
#define PyArg_VaParse			_PyArg_VaParse_SizeT
#define PyArg_VaParseTupleAndKeywords	_PyArg_VaParseTupleAndKeywords_SizeT
20 21 22 23
#define Py_BuildValue			_Py_BuildValue_SizeT
#define Py_VaBuildValue			_Py_VaBuildValue_SizeT
#else
PyAPI_FUNC(PyObject *) _Py_VaBuildValue_SizeT(const char *, va_list);
Martin v. Löwis's avatar
Martin v. Löwis committed
24 25
#endif

26 27
/* Due to a glitch in 3.2, the _SizeT versions weren't exported from the DLL. */
#if !defined(PY_SSIZE_T_CLEAN) || !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03030000
28
PyAPI_FUNC(int) PyArg_Parse(PyObject *, const char *, ...);
29
PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...);
30
PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
31
                                                  const char *, char **, ...);
32
PyAPI_FUNC(int) PyArg_ValidateKeywordArguments(PyObject *);
33
PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, const char *, Py_ssize_t, Py_ssize_t, ...);
34
PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...);
35
PyAPI_FUNC(PyObject *) _Py_BuildValue_SizeT(const char *, ...);
36
#endif
37
#ifndef Py_LIMITED_API
38
PyAPI_FUNC(int) _PyArg_NoKeywords(const char *funcname, PyObject *kw);
39
PyAPI_FUNC(int) _PyArg_NoPositional(const char *funcname, PyObject *args);
40

41
PyAPI_FUNC(int) PyArg_VaParse(PyObject *, const char *, va_list);
42
PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
43
                                                  const char *, char **, va_list);
44
#endif
45
PyAPI_FUNC(PyObject *) Py_VaBuildValue(const char *, va_list);
46

47 48 49
PyAPI_FUNC(int) PyModule_AddObject(PyObject *, const char *, PyObject *);
PyAPI_FUNC(int) PyModule_AddIntConstant(PyObject *, const char *, long);
PyAPI_FUNC(int) PyModule_AddStringConstant(PyObject *, const char *, const char *);
50 51
#define PyModule_AddIntMacro(m, c) PyModule_AddIntConstant(m, #c, c)
#define PyModule_AddStringMacro(m, c) PyModule_AddStringConstant(m, #c, c)
Martin v. Löwis's avatar
Martin v. Löwis committed
52

53 54
#define Py_CLEANUP_SUPPORTED 0x20000

55 56
#define PYTHON_API_VERSION 1013
#define PYTHON_API_STRING "1013"
Guido van Rossum's avatar
Guido van Rossum committed
57 58
/* The API version is maintained (independently from the Python version)
   so we can detect mismatches between the interpreter and dynamically
59
   loaded modules.  These are diagnosed by an error message but
60 61 62
   the module is still loaded (because the mismatch can only be tested
   after loading the module).  The error message is intended to
   explain the core dump a few seconds later.
Guido van Rossum's avatar
Guido van Rossum committed
63

64 65 66
   The symbol PYTHON_API_STRING defines the same value as a string
   literal.  *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***

Guido van Rossum's avatar
Guido van Rossum committed
67 68 69
   Please add a line or two to the top of this log for each API
   version change:

70
   22-Feb-2006  MvL	1013	PEP 353 - long indices for sequence lengths
71

72 73 74
   19-Aug-2002  GvR	1012	Changes to string object struct for
   				interning changes, saving 3 bytes.

75 76
   17-Jul-2001	GvR	1011	Descr-branch, just to be on the safe side

77 78 79
   25-Jan-2001  FLD     1010    Parameters added to PyCode_New() and
                                PyFrame_New(); Python 2.1a2

80 81
   14-Mar-2000  GvR     1009    Unicode API added

82 83 84
   3-Jan-1999	GvR	1007	Decided to change back!  (Don't reuse 1008!)

   3-Dec-1998	GvR	1008	Python 1.5.2b1
85 86

   18-Jan-1997	GvR	1007	string interning and other speedups
87

88 89
   11-Oct-1996	GvR	renamed Py_Ellipses to Py_Ellipsis :-(

90 91 92 93
   30-Jul-1996	GvR	Slice and ellipses syntax added

   23-Jul-1996	GvR	For 1.4 -- better safe than sorry this time :-)

Guido van Rossum's avatar
Guido van Rossum committed
94 95
   7-Nov-1995	GvR	Keyword arguments (should've been done at 1.3 :-( )

96 97
   10-Jan-1995	GvR	Renamed globals to new naming scheme

Guido van Rossum's avatar
Guido van Rossum committed
98 99 100
   9-Jan-1995	GvR	Initial version (incompatible with older API)
*/

101 102 103 104 105 106
/* The PYTHON_ABI_VERSION is introduced in PEP 384. For the lifetime of
   Python 3, it will stay at the value of 3; changes to the limited API
   must be performed in a strictly backwards-compatible manner. */
#define PYTHON_ABI_VERSION 3
#define PYTHON_ABI_STRING "3"

107
#ifdef Py_TRACE_REFS
108
 /* When we are tracing reference counts, rename PyModule_Create2 so
Martin v. Löwis's avatar
Martin v. Löwis committed
109 110
    modules compiled with incompatible settings will generate a
    link-time error. */
111
 #define PyModule_Create2 PyModule_Create2TraceRefs
112 113
#endif

114 115
PyAPI_FUNC(PyObject *) PyModule_Create2(struct PyModuleDef*,
                                     int apiver);
116

117 118 119 120
#ifdef Py_LIMITED_API
#define PyModule_Create(module) \
	PyModule_Create2(module, PYTHON_ABI_VERSION)
#else
121 122
#define PyModule_Create(module) \
	PyModule_Create2(module, PYTHON_API_VERSION)
123
#endif
124

125
#ifndef Py_LIMITED_API
126
PyAPI_DATA(char *) _Py_PackageContext;
127
#endif
128

129 130 131 132
#ifdef __cplusplus
}
#endif
#endif /* !Py_MODSUPPORT_H */