modsupport.h 3.71 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

12 13
PyAPI_FUNC(int) PyArg_Parse(PyObject *, const char *, ...);
PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...);
14
PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
15 16 17 18
                                                  const char *, const char **, ...);
PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, const char *, int, int, ...);
PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...);
PyAPI_FUNC(int) _PyArg_NoKeywords(const char *funcname, PyObject *kw);
19

20
PyAPI_FUNC(int) PyArg_VaParse(PyObject *, const char *, va_list);
21
PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
22 23
                                                  const char *, const char **, va_list);
PyAPI_FUNC(PyObject *) Py_VaBuildValue(const char *, va_list);
24

25 26 27
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 *);
28

29 30
#define PYTHON_API_VERSION 1012
#define PYTHON_API_STRING "1012"
Guido van Rossum's avatar
Guido van Rossum committed
31 32
/* The API version is maintained (independently from the Python version)
   so we can detect mismatches between the interpreter and dynamically
33
   loaded modules.  These are diagnosed by an error message but
34 35 36
   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
37

38 39 40
   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
41 42 43
   Please add a line or two to the top of this log for each API
   version change:

44 45 46
   19-Aug-2002  GvR	1012	Changes to string object struct for
   				interning changes, saving 3 bytes.

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

49 50 51
   25-Jan-2001  FLD     1010    Parameters added to PyCode_New() and
                                PyFrame_New(); Python 2.1a2

52 53
   14-Mar-2000  GvR     1009    Unicode API added

54 55 56
   3-Jan-1999	GvR	1007	Decided to change back!  (Don't reuse 1008!)

   3-Dec-1998	GvR	1008	Python 1.5.2b1
57 58

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

60 61
   11-Oct-1996	GvR	renamed Py_Ellipses to Py_Ellipsis :-(

62 63 64 65
   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
66 67
   7-Nov-1995	GvR	Keyword arguments (should've been done at 1.3 :-( )

68 69
   10-Jan-1995	GvR	Renamed globals to new naming scheme

Guido van Rossum's avatar
Guido van Rossum committed
70 71 72
   9-Jan-1995	GvR	Initial version (incompatible with older API)
*/

73
#ifdef MS_WINDOWS
74 75 76 77
/* Special defines for Windows versions used to live here.  Things
   have changed, and the "Version" is now in a global string variable.
   Reason for this is that this for easier branding of a "custom DLL"
   without actually needing a recompile.  */
78 79 80 81 82 83 84 85 86
#endif /* MS_WINDOWS */

#ifdef Py_TRACE_REFS
/* When we are tracing reference counts, rename Py_InitModule4 so
   modules compiled with incompatible settings will generate a
   link-time error. */
#define Py_InitModule4 Py_InitModule4TraceRefs
#endif

87 88 89
PyAPI_FUNC(PyObject *) Py_InitModule4(const char *name, PyMethodDef *methods,
                                      const char *doc, PyObject *self,
                                      int apiver);
90

91 92 93
#define Py_InitModule(name, methods) \
	Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
		       PYTHON_API_VERSION)
94

95 96 97 98
#define Py_InitModule3(name, methods, doc) \
	Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
		       PYTHON_API_VERSION)

99
PyAPI_DATA(char *) _Py_PackageContext;
100

101 102 103 104
#ifdef __cplusplus
}
#endif
#endif /* !Py_MODSUPPORT_H */