Home | History | Annotate | Download | only in python2.7
      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 /* If PY_SSIZE_T_CLEAN is defined, each functions treats #-specifier
     13    to mean Py_ssize_t */
     14 #ifdef PY_SSIZE_T_CLEAN
     15 #define PyArg_Parse			_PyArg_Parse_SizeT
     16 #define PyArg_ParseTuple		_PyArg_ParseTuple_SizeT
     17 #define PyArg_ParseTupleAndKeywords	_PyArg_ParseTupleAndKeywords_SizeT
     18 #define PyArg_VaParse			_PyArg_VaParse_SizeT
     19 #define PyArg_VaParseTupleAndKeywords	_PyArg_VaParseTupleAndKeywords_SizeT
     20 #define Py_BuildValue			_Py_BuildValue_SizeT
     21 #define Py_VaBuildValue			_Py_VaBuildValue_SizeT
     22 #else
     23 PyAPI_FUNC(PyObject *) _Py_VaBuildValue_SizeT(const char *, va_list);
     24 #endif
     25 
     26 PyAPI_FUNC(int) PyArg_Parse(PyObject *, const char *, ...);
     27 PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...) Py_FORMAT_PARSETUPLE(PyArg_ParseTuple, 2, 3);
     28 PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
     29                                                   const char *, char **, ...);
     30 PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, const char *, Py_ssize_t, Py_ssize_t, ...);
     31 PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...);
     32 PyAPI_FUNC(PyObject *) _Py_BuildValue_SizeT(const char *, ...);
     33 PyAPI_FUNC(int) _PyArg_NoKeywords(const char *funcname, PyObject *kw);
     34 
     35 PyAPI_FUNC(int) PyArg_VaParse(PyObject *, const char *, va_list);
     36 PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
     37                                                   const char *, char **, va_list);
     38 PyAPI_FUNC(PyObject *) Py_VaBuildValue(const char *, va_list);
     39 
     40 PyAPI_FUNC(int) PyModule_AddObject(PyObject *, const char *, PyObject *);
     41 PyAPI_FUNC(int) PyModule_AddIntConstant(PyObject *, const char *, long);
     42 PyAPI_FUNC(int) PyModule_AddStringConstant(PyObject *, const char *, const char *);
     43 #define PyModule_AddIntMacro(m, c) PyModule_AddIntConstant(m, #c, c)
     44 #define PyModule_AddStringMacro(m, c) PyModule_AddStringConstant(m, #c, c)
     45 
     46 #define PYTHON_API_VERSION 1013
     47 #define PYTHON_API_STRING "1013"
     48 /* The API version is maintained (independently from the Python version)
     49    so we can detect mismatches between the interpreter and dynamically
     50    loaded modules.  These are diagnosed by an error message but
     51    the module is still loaded (because the mismatch can only be tested
     52    after loading the module).  The error message is intended to
     53    explain the core dump a few seconds later.
     54 
     55    The symbol PYTHON_API_STRING defines the same value as a string
     56    literal.  *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
     57 
     58    Please add a line or two to the top of this log for each API
     59    version change:
     60 
     61    22-Feb-2006  MvL	1013	PEP 353 - long indices for sequence lengths
     62 
     63    19-Aug-2002  GvR	1012	Changes to string object struct for
     64    				interning changes, saving 3 bytes.
     65 
     66    17-Jul-2001	GvR	1011	Descr-branch, just to be on the safe side
     67 
     68    25-Jan-2001  FLD     1010    Parameters added to PyCode_New() and
     69                                 PyFrame_New(); Python 2.1a2
     70 
     71    14-Mar-2000  GvR     1009    Unicode API added
     72 
     73    3-Jan-1999	GvR	1007	Decided to change back!  (Don't reuse 1008!)
     74 
     75    3-Dec-1998	GvR	1008	Python 1.5.2b1
     76 
     77    18-Jan-1997	GvR	1007	string interning and other speedups
     78 
     79    11-Oct-1996	GvR	renamed Py_Ellipses to Py_Ellipsis :-(
     80 
     81    30-Jul-1996	GvR	Slice and ellipses syntax added
     82 
     83    23-Jul-1996	GvR	For 1.4 -- better safe than sorry this time :-)
     84 
     85    7-Nov-1995	GvR	Keyword arguments (should've been done at 1.3 :-( )
     86 
     87    10-Jan-1995	GvR	Renamed globals to new naming scheme
     88 
     89    9-Jan-1995	GvR	Initial version (incompatible with older API)
     90 */
     91 
     92 #ifdef MS_WINDOWS
     93 /* Special defines for Windows versions used to live here.  Things
     94    have changed, and the "Version" is now in a global string variable.
     95    Reason for this is that this for easier branding of a "custom DLL"
     96    without actually needing a recompile.  */
     97 #endif /* MS_WINDOWS */
     98 
     99 #if SIZEOF_SIZE_T != SIZEOF_INT
    100 /* On a 64-bit system, rename the Py_InitModule4 so that 2.4
    101    modules cannot get loaded into a 2.5 interpreter */
    102 #define Py_InitModule4 Py_InitModule4_64
    103 #endif
    104 
    105 #ifdef Py_TRACE_REFS
    106  /* When we are tracing reference counts, rename Py_InitModule4 so
    107     modules compiled with incompatible settings will generate a
    108     link-time error. */
    109  #if SIZEOF_SIZE_T != SIZEOF_INT
    110  #undef Py_InitModule4
    111  #define Py_InitModule4 Py_InitModule4TraceRefs_64
    112  #else
    113  #define Py_InitModule4 Py_InitModule4TraceRefs
    114  #endif
    115 #endif
    116 
    117 PyAPI_FUNC(PyObject *) Py_InitModule4(const char *name, PyMethodDef *methods,
    118                                       const char *doc, PyObject *self,
    119                                       int apiver);
    120 
    121 #define Py_InitModule(name, methods) \
    122 	Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
    123 		       PYTHON_API_VERSION)
    124 
    125 #define Py_InitModule3(name, methods, doc) \
    126 	Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
    127 		       PYTHON_API_VERSION)
    128 
    129 PyAPI_DATA(char *) _Py_PackageContext;
    130 
    131 #ifdef __cplusplus
    132 }
    133 #endif
    134 #endif /* !Py_MODSUPPORT_H */
    135