modsupport.h 3.41 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 14
PyAPI_FUNC(int) PyArg_Parse(PyObject *, char *, ...);
PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, char *, ...);
PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
15
                                                  char *, char **, ...);
16 17
PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, char *, int, int, ...);
PyAPI_FUNC(PyObject *) Py_BuildValue(char *, ...);
18

19 20
PyAPI_FUNC(int) PyArg_VaParse(PyObject *, char *, va_list);
PyAPI_FUNC(PyObject *) Py_VaBuildValue(char *, va_list);
21

22 23 24
PyAPI_FUNC(int) PyModule_AddObject(PyObject *, char *, PyObject *);
PyAPI_FUNC(int) PyModule_AddIntConstant(PyObject *, char *, long);
PyAPI_FUNC(int) PyModule_AddStringConstant(PyObject *, char *, char *);
25

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

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

41 42 43
   19-Aug-2002  GvR	1012	Changes to string object struct for
   				interning changes, saving 3 bytes.

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

46 47 48
   25-Jan-2001  FLD     1010    Parameters added to PyCode_New() and
                                PyFrame_New(); Python 2.1a2

49 50
   14-Mar-2000  GvR     1009    Unicode API added

51 52 53
   3-Jan-1999	GvR	1007	Decided to change back!  (Don't reuse 1008!)

   3-Dec-1998	GvR	1008	Python 1.5.2b1
54 55

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

57 58
   11-Oct-1996	GvR	renamed Py_Ellipses to Py_Ellipsis :-(

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

65 66
   10-Jan-1995	GvR	Renamed globals to new naming scheme

Guido van Rossum's avatar
Guido van Rossum committed
67 68 69
   9-Jan-1995	GvR	Initial version (incompatible with older API)
*/

70
#ifdef MS_WINDOWS
71 72 73 74
/* 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.  */
75 76 77 78 79 80 81 82 83
#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

84
PyAPI_FUNC(PyObject *) Py_InitModule4(char *name, PyMethodDef *methods,
85 86 87
                                            char *doc, PyObject *self,
                                            int apiver);

88 89 90
#define Py_InitModule(name, methods) \
	Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
		       PYTHON_API_VERSION)
91

92 93 94 95
#define Py_InitModule3(name, methods, doc) \
	Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
		       PYTHON_API_VERSION)

96
PyAPI_DATA(char *) _Py_PackageContext;
97

98 99 100 101
#ifdef __cplusplus
}
#endif
#endif /* !Py_MODSUPPORT_H */