blob: 442394cbc05e8a10cd6835b6d8811dd96326a0d1 [file] [log] [blame]
Guido van Rossuma3309961993-07-28 09:05:47 +00001#ifndef Py_MODSUPPORT_H
2#define Py_MODSUPPORT_H
3#ifdef __cplusplus
4extern "C" {
5#endif
6
Guido van Rossumf70e43a1991-02-19 12:39:46 +00007/***********************************************************
Guido van Rossum5799b521995-01-04 19:06:22 +00008Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
9The Netherlands.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000010
11 All Rights Reserved
12
Guido van Rossumd266eb41996-10-25 14:44:06 +000013Permission to use, copy, modify, and distribute this software and its
14documentation for any purpose and without fee is hereby granted,
Guido van Rossumf70e43a1991-02-19 12:39:46 +000015provided that the above copyright notice appear in all copies and that
Guido van Rossumd266eb41996-10-25 14:44:06 +000016both that copyright notice and this permission notice appear in
Guido van Rossumf70e43a1991-02-19 12:39:46 +000017supporting documentation, and that the names of Stichting Mathematisch
Guido van Rossumd266eb41996-10-25 14:44:06 +000018Centrum or CWI or Corporation for National Research Initiatives or
19CNRI not be used in advertising or publicity pertaining to
20distribution of the software without specific, written prior
21permission.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000022
Guido van Rossumd266eb41996-10-25 14:44:06 +000023While CWI is the initial source for this software, a modified version
24is made available by the Corporation for National Research Initiatives
25(CNRI) at the Internet address ftp://ftp.python.org.
26
27STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
28REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
29MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
30CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
31DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
32PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
33TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
34PERFORMANCE OF THIS SOFTWARE.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000035
36******************************************************************/
37
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000038/* Module support interface */
39
Guido van Rossumb6775db1994-08-01 11:34:53 +000040#ifdef HAVE_STDARG_PROTOTYPES
41
42#include <stdarg.h>
43
Guido van Rossumcaa63801995-01-12 11:45:45 +000044extern int PyArg_Parse Py_PROTO((PyObject *, char *, ...));
45extern int PyArg_ParseTuple Py_PROTO((PyObject *, char *, ...));
Guido van Rossum36280a71997-02-14 16:36:35 +000046extern int PyArg_ParseTupleAndKeywords Py_PROTO((PyObject *, PyObject *,
47 char *, char **, ...));
Guido van Rossumcaa63801995-01-12 11:45:45 +000048extern PyObject *Py_BuildValue Py_PROTO((char *, ...));
Guido van Rossumb6775db1994-08-01 11:34:53 +000049
50#else
51
52#include <varargs.h>
53
54/* Better to have no prototypes at all for varargs functions in this case */
Guido van Rossumcaa63801995-01-12 11:45:45 +000055extern int PyArg_Parse();
56extern int PyArg_ParseTuple();
57extern PyObject *Py_BuildValue();
Guido van Rossumb6775db1994-08-01 11:34:53 +000058
Guido van Rossume5372401993-03-16 12:15:04 +000059#endif
60
Guido van Rossumcaa63801995-01-12 11:45:45 +000061extern int PyArg_VaParse Py_PROTO((PyObject *, char *, va_list));
62extern PyObject *Py_VaBuildValue Py_PROTO((char *, va_list));
Guido van Rossume5372401993-03-16 12:15:04 +000063
Guido van Rossumee5cf9b1997-01-18 07:54:03 +000064#define PYTHON_API_VERSION 1007
65#define PYTHON_API_STRING "1007"
Guido van Rossum970a0a21995-01-09 17:47:20 +000066/* The API version is maintained (independently from the Python version)
67 so we can detect mismatches between the interpreter and dynamically
Guido van Rossumae8a99e1996-07-30 16:41:02 +000068 loaded modules. These are diagnosticised by an error message but
69 the module is still loaded (because the mismatch can only be tested
70 after loading the module). The error message is intended to
71 explain the core dump a few seconds later.
Guido van Rossum970a0a21995-01-09 17:47:20 +000072
Guido van Rossum2ea0b061996-08-22 22:55:47 +000073 The symbol PYTHON_API_STRING defines the same value as a string
74 literal. *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
75
Guido van Rossum970a0a21995-01-09 17:47:20 +000076 Please add a line or two to the top of this log for each API
77 version change:
78
Guido van Rossumee5cf9b1997-01-18 07:54:03 +000079 18-Jan-1997 GvR string interning and other speedups
80
Guido van Rossume449af71996-10-11 16:25:41 +000081 11-Oct-1996 GvR renamed Py_Ellipses to Py_Ellipsis :-(
82
Guido van Rossumae8a99e1996-07-30 16:41:02 +000083 30-Jul-1996 GvR Slice and ellipses syntax added
84
85 23-Jul-1996 GvR For 1.4 -- better safe than sorry this time :-)
86
Guido van Rossume0dbd591996-01-12 00:49:39 +000087 7-Nov-1995 GvR Keyword arguments (should've been done at 1.3 :-( )
88
Guido van Rossumcaa63801995-01-12 11:45:45 +000089 10-Jan-1995 GvR Renamed globals to new naming scheme
90
Guido van Rossum970a0a21995-01-09 17:47:20 +000091 9-Jan-1995 GvR Initial version (incompatible with older API)
92*/
93
Guido van Rossum2ea0b061996-08-22 22:55:47 +000094#ifdef MS_WINDOWS
Guido van Rossumb4cfdfa1997-09-29 23:29:08 +000095/* Special defines for Windows versions used to live here. Things
96 have changed, and the "Version" is now in a global string variable.
97 Reason for this is that this for easier branding of a "custom DLL"
98 without actually needing a recompile. */
Guido van Rossum2ea0b061996-08-22 22:55:47 +000099#endif /* MS_WINDOWS */
100
101#ifdef Py_TRACE_REFS
102/* When we are tracing reference counts, rename Py_InitModule4 so
103 modules compiled with incompatible settings will generate a
104 link-time error. */
105#define Py_InitModule4 Py_InitModule4TraceRefs
106#endif
107
Guido van Rossumcaa63801995-01-12 11:45:45 +0000108extern PyObject *Py_InitModule4 Py_PROTO((char *, PyMethodDef *,
109 char *, PyObject *, int));
110#define Py_InitModule(name, methods) \
111 Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
112 PYTHON_API_VERSION)
Guido van Rossuma3309961993-07-28 09:05:47 +0000113
Guido van Rossuma70d1601998-06-27 18:21:59 +0000114#define Py_InitModule3(name, methods, doc) \
115 Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
116 PYTHON_API_VERSION)
117
Guido van Rossumee6fd1c1997-11-19 18:51:35 +0000118extern char *_Py_PackageContext;
119
Guido van Rossuma3309961993-07-28 09:05:47 +0000120#ifdef __cplusplus
121}
122#endif
123#endif /* !Py_MODSUPPORT_H */