| Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 1 |  | 
| Fred Drake | d5c84ed | 2000-07-08 17:25:55 +0000 | [diff] [blame] | 2 | #ifndef Py_MODSUPPORT_H | 
 | 3 | #define Py_MODSUPPORT_H | 
 | 4 | #ifdef __cplusplus | 
 | 5 | extern "C" { | 
 | 6 | #endif | 
 | 7 |  | 
| Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 8 | /* Module support interface */ | 
 | 9 |  | 
| Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 10 | #include <stdarg.h> | 
 | 11 |  | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 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 | 
| Martin v. Löwis | 5cb6936 | 2006-04-14 09:08:42 +0000 | [diff] [blame] | 20 | #define Py_BuildValue			_Py_BuildValue_SizeT | 
 | 21 | #define Py_VaBuildValue			_Py_VaBuildValue_SizeT | 
| Anthony Baxter | 46854bc | 2006-04-04 12:27:20 +0000 | [diff] [blame] | 22 | #else | 
| Anthony Baxter | 46854bc | 2006-04-04 12:27:20 +0000 | [diff] [blame] | 23 | PyAPI_FUNC(PyObject *) _Py_VaBuildValue_SizeT(const char *, va_list); | 
 | 24 | #endif | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 25 |  | 
| Jeremy Hylton | af68c87 | 2005-12-10 18:50:16 +0000 | [diff] [blame] | 26 | PyAPI_FUNC(int) PyArg_Parse(PyObject *, const char *, ...); | 
| Martin v. Löwis | aac1316 | 2006-10-19 10:58:46 +0000 | [diff] [blame] | 27 | PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...) Py_FORMAT_PARSETUPLE(PyArg_ParseTuple, 2, 3); | 
| Mark Hammond | 91a681d | 2002-08-12 07:21:58 +0000 | [diff] [blame] | 28 | PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *, | 
| Martin v. Löwis | 15e6274 | 2006-02-27 16:46:16 +0000 | [diff] [blame] | 29 |                                                   const char *, char **, ...); | 
| Martin v. Löwis | 7624674 | 2006-03-01 04:06:10 +0000 | [diff] [blame] | 30 | PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, const char *, Py_ssize_t, Py_ssize_t, ...); | 
| Jeremy Hylton | af68c87 | 2005-12-10 18:50:16 +0000 | [diff] [blame] | 31 | PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...); | 
| Skip Montanaro | 3fca463 | 2006-04-18 00:29:29 +0000 | [diff] [blame] | 32 | PyAPI_FUNC(PyObject *) _Py_BuildValue_SizeT(const char *, ...); | 
| Jeremy Hylton | af68c87 | 2005-12-10 18:50:16 +0000 | [diff] [blame] | 33 | PyAPI_FUNC(int) _PyArg_NoKeywords(const char *funcname, PyObject *kw); | 
| Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 34 |  | 
| Jeremy Hylton | af68c87 | 2005-12-10 18:50:16 +0000 | [diff] [blame] | 35 | PyAPI_FUNC(int) PyArg_VaParse(PyObject *, const char *, va_list); | 
| Brett Cannon | 711e7d9 | 2004-07-10 22:20:32 +0000 | [diff] [blame] | 36 | PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *, | 
| Martin v. Löwis | 15e6274 | 2006-02-27 16:46:16 +0000 | [diff] [blame] | 37 |                                                   const char *, char **, va_list); | 
| Jeremy Hylton | af68c87 | 2005-12-10 18:50:16 +0000 | [diff] [blame] | 38 | PyAPI_FUNC(PyObject *) Py_VaBuildValue(const char *, va_list); | 
| Guido van Rossum | e537240 | 1993-03-16 12:15:04 +0000 | [diff] [blame] | 39 |  | 
| Jeremy Hylton | af68c87 | 2005-12-10 18:50:16 +0000 | [diff] [blame] | 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 *); | 
| Christian Heimes | 74b8e76 | 2008-01-22 15:25:18 +0000 | [diff] [blame] | 43 | #define PyModule_AddIntMacro(m, c) PyModule_AddIntConstant(m, #c, c) | 
 | 44 | #define PyModule_AddStringMacro(m, c) PyModule_AddStringConstant(m, #c, c) | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 45 |  | 
| Thomas Wouters | 34aa7ba | 2006-02-28 19:02:24 +0000 | [diff] [blame] | 46 | #define PYTHON_API_VERSION 1013 | 
 | 47 | #define PYTHON_API_STRING "1013" | 
| Guido van Rossum | 970a0a2 | 1995-01-09 17:47:20 +0000 | [diff] [blame] | 48 | /* The API version is maintained (independently from the Python version) | 
 | 49 |    so we can detect mismatches between the interpreter and dynamically | 
| Thomas Wouters | 7e47402 | 2000-07-16 12:04:32 +0000 | [diff] [blame] | 50 |    loaded modules.  These are diagnosed by an error message but | 
| Guido van Rossum | ae8a99e | 1996-07-30 16:41:02 +0000 | [diff] [blame] | 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. | 
| Guido van Rossum | 970a0a2 | 1995-01-09 17:47:20 +0000 | [diff] [blame] | 54 |  | 
| Guido van Rossum | 2ea0b06 | 1996-08-22 22:55:47 +0000 | [diff] [blame] | 55 |    The symbol PYTHON_API_STRING defines the same value as a string | 
 | 56 |    literal.  *** PLEASE MAKE SURE THE DEFINITIONS MATCH. *** | 
 | 57 |  | 
| Guido van Rossum | 970a0a2 | 1995-01-09 17:47:20 +0000 | [diff] [blame] | 58 |    Please add a line or two to the top of this log for each API | 
 | 59 |    version change: | 
 | 60 |  | 
| Neal Norwitz | e42e405 | 2006-02-28 20:03:28 +0000 | [diff] [blame] | 61 |    22-Feb-2006  MvL	1013	PEP 353 - long indices for sequence lengths | 
| Thomas Wouters | 34aa7ba | 2006-02-28 19:02:24 +0000 | [diff] [blame] | 62 |  | 
| Guido van Rossum | 45ec02a | 2002-08-19 21:43:18 +0000 | [diff] [blame] | 63 |    19-Aug-2002  GvR	1012	Changes to string object struct for | 
 | 64 |    				interning changes, saving 3 bytes. | 
 | 65 |  | 
| Tim Peters | 6d6c1a3 | 2001-08-02 04:15:00 +0000 | [diff] [blame] | 66 |    17-Jul-2001	GvR	1011	Descr-branch, just to be on the safe side | 
 | 67 |  | 
| Fred Drake | 73a3c8f | 2001-01-25 22:13:34 +0000 | [diff] [blame] | 68 |    25-Jan-2001  FLD     1010    Parameters added to PyCode_New() and | 
 | 69 |                                 PyFrame_New(); Python 2.1a2 | 
 | 70 |  | 
| Guido van Rossum | 21a50bd | 2000-03-29 01:46:45 +0000 | [diff] [blame] | 71 |    14-Mar-2000  GvR     1009    Unicode API added | 
 | 72 |  | 
| Guido van Rossum | f1176c4 | 1999-01-03 12:40:24 +0000 | [diff] [blame] | 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 | 
| Guido van Rossum | 7531d50 | 1998-12-03 18:18:12 +0000 | [diff] [blame] | 76 |  | 
 | 77 |    18-Jan-1997	GvR	1007	string interning and other speedups | 
| Guido van Rossum | ee5cf9b | 1997-01-18 07:54:03 +0000 | [diff] [blame] | 78 |  | 
| Guido van Rossum | e449af7 | 1996-10-11 16:25:41 +0000 | [diff] [blame] | 79 |    11-Oct-1996	GvR	renamed Py_Ellipses to Py_Ellipsis :-( | 
 | 80 |  | 
| Guido van Rossum | ae8a99e | 1996-07-30 16:41:02 +0000 | [diff] [blame] | 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 |  | 
| Guido van Rossum | e0dbd59 | 1996-01-12 00:49:39 +0000 | [diff] [blame] | 85 |    7-Nov-1995	GvR	Keyword arguments (should've been done at 1.3 :-( ) | 
 | 86 |  | 
| Guido van Rossum | caa6380 | 1995-01-12 11:45:45 +0000 | [diff] [blame] | 87 |    10-Jan-1995	GvR	Renamed globals to new naming scheme | 
 | 88 |  | 
| Guido van Rossum | 970a0a2 | 1995-01-09 17:47:20 +0000 | [diff] [blame] | 89 |    9-Jan-1995	GvR	Initial version (incompatible with older API) | 
 | 90 | */ | 
 | 91 |  | 
| Guido van Rossum | 2ea0b06 | 1996-08-22 22:55:47 +0000 | [diff] [blame] | 92 | #ifdef MS_WINDOWS | 
| Guido van Rossum | b4cfdfa | 1997-09-29 23:29:08 +0000 | [diff] [blame] | 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.  */ | 
| Guido van Rossum | 2ea0b06 | 1996-08-22 22:55:47 +0000 | [diff] [blame] | 97 | #endif /* MS_WINDOWS */ | 
 | 98 |  | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 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 |  | 
| Guido van Rossum | 2ea0b06 | 1996-08-22 22:55:47 +0000 | [diff] [blame] | 105 | #ifdef Py_TRACE_REFS | 
| Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 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 | 
| Guido van Rossum | 2ea0b06 | 1996-08-22 22:55:47 +0000 | [diff] [blame] | 115 | #endif | 
 | 116 |  | 
| Jeremy Hylton | af68c87 | 2005-12-10 18:50:16 +0000 | [diff] [blame] | 117 | PyAPI_FUNC(PyObject *) Py_InitModule4(const char *name, PyMethodDef *methods, | 
 | 118 |                                       const char *doc, PyObject *self, | 
 | 119 |                                       int apiver); | 
| Fred Drake | d5c84ed | 2000-07-08 17:25:55 +0000 | [diff] [blame] | 120 |  | 
| Guido van Rossum | caa6380 | 1995-01-12 11:45:45 +0000 | [diff] [blame] | 121 | #define Py_InitModule(name, methods) \ | 
 | 122 | 	Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \ | 
 | 123 | 		       PYTHON_API_VERSION) | 
| Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 124 |  | 
| Guido van Rossum | a70d160 | 1998-06-27 18:21:59 +0000 | [diff] [blame] | 125 | #define Py_InitModule3(name, methods, doc) \ | 
 | 126 | 	Py_InitModule4(name, methods, doc, (PyObject *)NULL, \ | 
 | 127 | 		       PYTHON_API_VERSION) | 
 | 128 |  | 
| Mark Hammond | 91a681d | 2002-08-12 07:21:58 +0000 | [diff] [blame] | 129 | PyAPI_DATA(char *) _Py_PackageContext; | 
| Guido van Rossum | ee6fd1c | 1997-11-19 18:51:35 +0000 | [diff] [blame] | 130 |  | 
| Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 131 | #ifdef __cplusplus | 
 | 132 | } | 
 | 133 | #endif | 
 | 134 | #endif /* !Py_MODSUPPORT_H */ |