Include/modsupport.h

   1
   2 #ifndef Py_MODSUPPORT_H
   3 #define Py_MODSUPPORT_H
   4 #ifdef __cplusplus
   5 extern "C" {
   6 #endif
   7
   8 /* Module support interface */
   9
  10 #include <stdarg.h>
  11
  12 extern DL_IMPORT(int) PyArg_Parse(PyObject *, char *, ...);
  13 extern DL_IMPORT(int) PyArg_ParseTuple(PyObject *, char *, ...);
  14 extern DL_IMPORT(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
  15                                                   char *, char **, ...);
  16 extern DL_IMPORT(PyObject *) Py_BuildValue(char *, ...);
  17
  18 extern DL_IMPORT(int) PyArg_VaParse(PyObject *, char *, va_list);
  19 extern DL_IMPORT(PyObject *) Py_VaBuildValue(char *, va_list);
  20
  21 extern DL_IMPORT(int) PyModule_AddObject(PyObject *, char *, PyObject *);
  22 extern DL_IMPORT(int) PyModule_AddIntConstant(PyObject *, char *, long);
  23 extern DL_IMPORT(int) PyModule_AddStringConstant(PyObject *, char *, char *);
  24
  25 #define PYTHON_API_VERSION 1011
  26 #define PYTHON_API_STRING "1011"
  27 /* The API version is maintained (independently from the Python version)
  28    so we can detect mismatches between the interpreter and dynamically
  29    loaded modules.  These are diagnosed by an error message but
  30    the module is still loaded (because the mismatch can only be tested
  31    after loading the module).  The error message is intended to
  32    explain the core dump a few seconds later.
  33
  34    The symbol PYTHON_API_STRING defines the same value as a string
  35    literal.  *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
  36
  37    Please add a line or two to the top of this log for each API
  38    version change:
  39
  40    17-Jul-2001  GvR     1011    Descr-branch, just to be on the safe side
  41
  42    25-Jan-2001  FLD     1010    Parameters added to PyCode_New() and
  43                                 PyFrame_New(); Python 2.1a2
  44
  45    14-Mar-2000  GvR     1009    Unicode API added
  46
  47    3-Jan-1999   GvR     1007    Decided to change back!  (Don't reuse 1008!)
  48
  49    3-Dec-1998   GvR     1008    Python 1.5.2b1
  50
  51    18-Jan-1997  GvR     1007    string interning and other speedups
  52
  53    11-Oct-1996  GvR     renamed Py_Ellipses to Py_Ellipsis :-(
  54
  55    30-Jul-1996  GvR     Slice and ellipses syntax added
  56
  57    23-Jul-1996  GvR     For 1.4 -- better safe than sorry this time :-)
  58
  59    7-Nov-1995   GvR     Keyword arguments (should've been done at 1.3 :-( )
  60
  61    10-Jan-1995  GvR     Renamed globals to new naming scheme
  62
  63    9-Jan-1995   GvR     Initial version (incompatible with older API)
  64 */
  65
  66 #ifdef MS_WINDOWS
  67 /* Special defines for Windows versions used to live here.  Things
  68    have changed, and the "Version" is now in a global string variable.
  69    Reason for this is that this for easier branding of a "custom DLL"
  70    without actually needing a recompile.  */
  71 #endif /* MS_WINDOWS */
  72
  73 #ifdef Py_TRACE_REFS
  74 /* When we are tracing reference counts, rename Py_InitModule4 so
  75    modules compiled with incompatible settings will generate a
  76    link-time error. */
  77 #define Py_InitModule4 Py_InitModule4TraceRefs
  78 #endif
  79
  80 extern DL_IMPORT(PyObject *) Py_InitModule4(char *name, PyMethodDef *methods,
  81                                             char *doc, PyObject *self,
  82                                             int apiver);
  83
  84 #define Py_InitModule(name, methods) \
  85         Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
  86                        PYTHON_API_VERSION)
  87
  88 #define Py_InitModule3(name, methods, doc) \
  89         Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
  90                        PYTHON_API_VERSION)
  91
  92 extern DL_IMPORT(char *) _Py_PackageContext;
  93
  94 #ifdef __cplusplus
  95 }
  96 #endif
  97 #endif /* !Py_MODSUPPORT_H */