Rooba
/
cpython
mirror of https://github.com/python/cpython.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
cpython/Include/modsupport.h

131 lines
4.6 KiB
C
Raw Normal View History

Added copyright notice.
1991-02-19 12:39:46 +00:00
ANSI-fication of the sources -- remove Py_PROTO!
2000-07-08 17:25:55 +00:00
#ifndef Py_MODSUPPORT_H
#define Py_MODSUPPORT_H
#ifdef __cplusplus
extern "C" {
#endif
Initial revision
1990-10-14 12:07:46 +00:00
/* Module support interface */
* Changed many files to use mkvalue() instead of newtupleobject(). * Fixcprt.py: added [-y file] option, do only files younger than file. * modsupport.[ch]: added vmkvalue(). * intobject.c: use mkvalue(). * stringobject.c: added "formatstring"; renamed string* to string_*; ceval.c: call formatstring for string % value. * longobject.c: close memory leak in divmod. * parsetok.c: set result node to NULL when returning an error.
1993-03-16 12:15:04 +00:00
#include <stdarg.h>
Merge alpha100 branch back to main trunk
1994-08-01 11:34:53 +00:00
Merge ssize_t branch.
2006-02-15 17:27:45 +00:00
/* If PY_SSIZE_T_CLEAN is defined, each functions treats #-specifier
to mean Py_ssize_t */
#ifdef PY_SSIZE_T_CLEAN
#define PyArg_Parse _PyArg_Parse_SizeT
#define PyArg_ParseTuple _PyArg_ParseTuple_SizeT
#define PyArg_ParseTupleAndKeywords _PyArg_ParseTupleAndKeywords_SizeT
#define PyArg_VaParse _PyArg_VaParse_SizeT
#define PyArg_VaParseTupleAndKeywords _PyArg_VaParseTupleAndKeywords_SizeT
#define PyArg_BuildValue _PyArg_BuildValue_SizeT
#define PyArg_VaBuildValue _PyArg_VaBuildValue_SizeT
#endif
Add const to several API functions that take char *. In C++, it's an error to pass a string literal to a char* function without a const_cast(). Rather than require every C++ extension module to put a cast around string literals, fix the API to state the const-ness. I focused on parts of the API where people usually pass literals: PyArg_ParseTuple() and friends, Py_BuildValue(), PyMethodDef, the type slots, etc. Predictably, there were a large set of functions that needed to be fixed as a result of these changes. The most pervasive change was to make the keyword args list passed to PyArg_ParseTupleAndKewords() to be a const char *kwlist[]. One cast was required as a result of the changes: A type object mallocs the memory for its tp_doc slot and later frees it. PyTypeObject says that tp_doc is const char *; but if the type was created by type_new(), we know it is safe to cast to char *.
2005-12-10 18:50:16 +00:00
PyAPI_FUNC(int) PyArg_Parse(PyObject *, const char *, ...);
PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...);
Excise DL_EXPORT from Include. Thanks to Skip Montanaro and Kalle Svensson for the patches.
2002-08-12 07:21:58 +00:00
PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
Revert backwards-incompatible const changes.
2006-02-27 16:46:16 +00:00
const char *, char **, ...);
Use Py_ssize_t for PyArg_UnpackTuple arguments.
2006-03-01 04:06:10 +00:00
PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, const char *, Py_ssize_t, Py_ssize_t, ...);
Add const to several API functions that take char *. In C++, it's an error to pass a string literal to a char* function without a const_cast(). Rather than require every C++ extension module to put a cast around string literals, fix the API to state the const-ness. I focused on parts of the API where people usually pass literals: PyArg_ParseTuple() and friends, Py_BuildValue(), PyMethodDef, the type slots, etc. Predictably, there were a large set of functions that needed to be fixed as a result of these changes. The most pervasive change was to make the keyword args list passed to PyArg_ParseTupleAndKewords() to be a const char *kwlist[]. One cast was required as a result of the changes: A type object mallocs the memory for its tp_doc slot and later frees it. PyTypeObject says that tp_doc is const char *; but if the type was created by type_new(), we know it is safe to cast to char *.
2005-12-10 18:50:16 +00:00
PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...);
PyAPI_FUNC(int) _PyArg_NoKeywords(const char *funcname, PyObject *kw);
Merge alpha100 branch back to main trunk
1994-08-01 11:34:53 +00:00
Add const to several API functions that take char *. In C++, it's an error to pass a string literal to a char* function without a const_cast(). Rather than require every C++ extension module to put a cast around string literals, fix the API to state the const-ness. I focused on parts of the API where people usually pass literals: PyArg_ParseTuple() and friends, Py_BuildValue(), PyMethodDef, the type slots, etc. Predictably, there were a large set of functions that needed to be fixed as a result of these changes. The most pervasive change was to make the keyword args list passed to PyArg_ParseTupleAndKewords() to be a const char *kwlist[]. One cast was required as a result of the changes: A type object mallocs the memory for its tp_doc slot and later frees it. PyTypeObject says that tp_doc is const char *; but if the type was created by type_new(), we know it is safe to cast to char *.
2005-12-10 18:50:16 +00:00
PyAPI_FUNC(int) PyArg_VaParse(PyObject *, const char *, va_list);
Add PyArg_VaParseTupleAndKeywords(). Document this function and PyArg_VaParse(). Closes patch #550732. Thanks Greg Chapman.
2004-07-10 22:20:32 +00:00
PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
Revert backwards-incompatible const changes.
2006-02-27 16:46:16 +00:00
const char *, char **, va_list);
Add const to several API functions that take char *. In C++, it's an error to pass a string literal to a char* function without a const_cast(). Rather than require every C++ extension module to put a cast around string literals, fix the API to state the const-ness. I focused on parts of the API where people usually pass literals: PyArg_ParseTuple() and friends, Py_BuildValue(), PyMethodDef, the type slots, etc. Predictably, there were a large set of functions that needed to be fixed as a result of these changes. The most pervasive change was to make the keyword args list passed to PyArg_ParseTupleAndKewords() to be a const char *kwlist[]. One cast was required as a result of the changes: A type object mallocs the memory for its tp_doc slot and later frees it. PyTypeObject says that tp_doc is const char *; but if the type was created by type_new(), we know it is safe to cast to char *.
2005-12-10 18:50:16 +00:00
PyAPI_FUNC(PyObject *) Py_VaBuildValue(const char *, va_list);
New getargs() function. Define macros with conventional names, except get*str*arg --> get*Str*arg; get*str*arg fetches a C string.
1992-01-27 16:50:21 +00:00
Add const to several API functions that take char *. In C++, it's an error to pass a string literal to a char* function without a const_cast(). Rather than require every C++ extension module to put a cast around string literals, fix the API to state the const-ness. I focused on parts of the API where people usually pass literals: PyArg_ParseTuple() and friends, Py_BuildValue(), PyMethodDef, the type slots, etc. Predictably, there were a large set of functions that needed to be fixed as a result of these changes. The most pervasive change was to make the keyword args list passed to PyArg_ParseTupleAndKewords() to be a const char *kwlist[]. One cast was required as a result of the changes: A type object mallocs the memory for its tp_doc slot and later frees it. PyTypeObject says that tp_doc is const char *; but if the type was created by type_new(), we know it is safe to cast to char *.
2005-12-10 18:50:16 +00:00
PyAPI_FUNC(int) PyModule_AddObject(PyObject *, const char *, PyObject *);
PyAPI_FUNC(int) PyModule_AddIntConstant(PyObject *, const char *, long);
PyAPI_FUNC(int) PyModule_AddStringConstant(PyObject *, const char *, const char *);
Andrew Kuchling <akuchlin@mems-exchange.org>: Add three new convenience functions to the PyModule_*() family: PyModule_AddObject(), PyModule_AddIntConstant(), PyModule_AddStringConstant(). This closes SourceForge patch #101233.
2000-09-23 03:24:27 +00:00
Merge ssize_t branch.
2006-02-15 17:27:45 +00:00
from __future__ import with_statement addon for 'with', mostly written by Neal.
2006-02-28 19:02:24 +00:00
#define PYTHON_API_VERSION 1013
#define PYTHON_API_STRING "1013"
api version checking
1995-01-09 17:47:20 +00:00
/* The API version is maintained (independently from the Python version)
so we can detect mismatches between the interpreter and dynamically
Spelling fixes supplied by Rob W. W. Hooft. All these are fixes in either comments, docstrings or error messages. I fixed two minor things in test_winreg.py ("didn't" -> "Didn't" and "Didnt" -> "Didn't"). There is a minor style issue involved: Guido seems to have preferred English grammar (behaviour, honour) in a couple places. This patch changes that to American, which is the more prominent style in the source. I prefer English myself, so if English is preferred, I'd be happy to supply a patch myself ;)
2000-07-16 12:04:32 +00:00
loaded modules. These are diagnosed by an error message but
Two bumps for the price of one (PYTHON_API_VERSION)
1996-07-30 16:41:02 +00:00
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.
api version checking
1995-01-09 17:47:20 +00:00
Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal. Under Windows, add MS_DLL_ID and MS_DLL_VERSION_ID for Mark H. Independent change: if Py_TRACE_REFS is defined, rename Py_InitModule4 so so linking with incompatible modules will create a link time error. [Backing out of previous changes (also for modsupport.c) to test the latter at runtime.]
1996-08-22 22:55:47 +00:00
The symbol PYTHON_API_STRING defines the same value as a string
literal. *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
api version checking
1995-01-09 17:47:20 +00:00
Please add a line or two to the top of this log for each API
version change:
Martin owns PEP 353 and did most of the work
2006-02-28 20:03:28 +00:00
22-Feb-2006 MvL 1013 PEP 353 - long indices for sequence lengths
from __future__ import with_statement addon for 'with', mostly written by Neal.
2006-02-28 19:02:24 +00:00
SF patch 576101, by Oren Tirosh: alternative implementation of interning. I modified Oren's patch significantly, but the basic idea and most of the implementation is unchanged. Interned strings created with PyString_InternInPlace() are now mortal, and you must keep a reference to the resulting string around; use the new function PyString_InternImmortal() to create immortal interned strings.
2002-08-19 21:43:18 +00:00
19-Aug-2002 GvR 1012 Changes to string object struct for
interning changes, saving 3 bytes.
Merge of descr-branch back into trunk.
2001-08-02 04:15:00 +00:00
17-Jul-2001 GvR 1011 Descr-branch, just to be on the safe side
The addition of new parameters to functions in the Python/C API requires that PYTHON_API_VERSION be incremented.
2001-01-25 22:13:34 +00:00
25-Jan-2001 FLD 1010 Parameters added to PyCode_New() and
PyFrame_New(); Python 2.1a2
Version updated to 1.6; API version to 1009.
2000-03-29 01:46:45 +00:00
14-Mar-2000 GvR 1009 Unicode API added
New version identification scheme. The version numbers are now exported by Python.h. Also rolled back the API version change -- it's back to 1007!
1999-01-03 12:40:24 +00:00
3-Jan-1999 GvR 1007 Decided to change back! (Don't reuse 1008!)
3-Dec-1998 GvR 1008 Python 1.5.2b1
New API version (enough has changed!).
1998-12-03 18:18:12 +00:00
18-Jan-1997 GvR 1007 string interning and other speedups
Bump API version due to the various speedup hacks.
1997-01-18 07:54:03 +00:00
Ellipses -> Ellipsis rename (the dictionary really says that it should be Ellipsis!). Bumped the API version because a linker-visible symbol is affected. Old C code will still compile -- there's a b/w compat macro. Similarly, old Python code will still run, builtin exports both Ellipses and Ellipsis.
1996-10-11 16:25:41 +00:00
11-Oct-1996 GvR renamed Py_Ellipses to Py_Ellipsis :-(
Two bumps for the price of one (PYTHON_API_VERSION)
1996-07-30 16:41:02 +00:00
30-Jul-1996 GvR Slice and ellipses syntax added
23-Jul-1996 GvR For 1.4 -- better safe than sorry this time :-)
bump api version
1996-01-12 00:49:39 +00:00
7-Nov-1995 GvR Keyword arguments (should've been done at 1.3 :-( )
The great renaming, phase two: all header files have been updated to use the new names exclusively, and the linker will see the new names. Files that import "Python.h" also only see the new names. Files that import "allobjects.h" will continue to be able to use the old names, due to the inclusion (in allobjects.h) of "rename2.h".
1995-01-12 11:45:45 +00:00
10-Jan-1995 GvR Renamed globals to new naming scheme
api version checking
1995-01-09 17:47:20 +00:00
9-Jan-1995 GvR Initial version (incompatible with older API)
*/
Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal. Under Windows, add MS_DLL_ID and MS_DLL_VERSION_ID for Mark H. Independent change: if Py_TRACE_REFS is defined, rename Py_InitModule4 so so linking with incompatible modules will create a link time error. [Backing out of previous changes (also for modsupport.c) to test the latter at runtime.]
1996-08-22 22:55:47 +00:00
#ifdef MS_WINDOWS
Removed special Windows defines, at Mark Hammond's request.
1997-09-29 23:29:08 +00:00
/* 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. */
Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal. Under Windows, add MS_DLL_ID and MS_DLL_VERSION_ID for Mark H. Independent change: if Py_TRACE_REFS is defined, rename Py_InitModule4 so so linking with incompatible modules will create a link time error. [Backing out of previous changes (also for modsupport.c) to test the latter at runtime.]
1996-08-22 22:55:47 +00:00
#endif /* MS_WINDOWS */
Merge ssize_t branch.
2006-02-15 17:27:45 +00:00
#if SIZEOF_SIZE_T != SIZEOF_INT
/* On a 64-bit system, rename the Py_InitModule4 so that 2.4
modules cannot get loaded into a 2.5 interpreter */
#define Py_InitModule4 Py_InitModule4_64
#endif
Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal. Under Windows, add MS_DLL_ID and MS_DLL_VERSION_ID for Mark H. Independent change: if Py_TRACE_REFS is defined, rename Py_InitModule4 so so linking with incompatible modules will create a link time error. [Backing out of previous changes (also for modsupport.c) to test the latter at runtime.]
1996-08-22 22:55:47 +00:00
#ifdef Py_TRACE_REFS
Merge ssize_t branch.
2006-02-15 17:27:45 +00:00
/* When we are tracing reference counts, rename Py_InitModule4 so
modules compiled with incompatible settings will generate a
link-time error. */
#if SIZEOF_SIZE_T != SIZEOF_INT
#undef Py_InitModule4
#define Py_InitModule4 Py_InitModule4TraceRefs_64
#else
#define Py_InitModule4 Py_InitModule4TraceRefs
#endif
Add PYTHON_API_STRING, which is PYTHON_API_VERSION as a string literal. Under Windows, add MS_DLL_ID and MS_DLL_VERSION_ID for Mark H. Independent change: if Py_TRACE_REFS is defined, rename Py_InitModule4 so so linking with incompatible modules will create a link time error. [Backing out of previous changes (also for modsupport.c) to test the latter at runtime.]
1996-08-22 22:55:47 +00:00
#endif
Add const to several API functions that take char *. In C++, it's an error to pass a string literal to a char* function without a const_cast(). Rather than require every C++ extension module to put a cast around string literals, fix the API to state the const-ness. I focused on parts of the API where people usually pass literals: PyArg_ParseTuple() and friends, Py_BuildValue(), PyMethodDef, the type slots, etc. Predictably, there were a large set of functions that needed to be fixed as a result of these changes. The most pervasive change was to make the keyword args list passed to PyArg_ParseTupleAndKewords() to be a const char *kwlist[]. One cast was required as a result of the changes: A type object mallocs the memory for its tp_doc slot and later frees it. PyTypeObject says that tp_doc is const char *; but if the type was created by type_new(), we know it is safe to cast to char *.
2005-12-10 18:50:16 +00:00
PyAPI_FUNC(PyObject *) Py_InitModule4(const char *name, PyMethodDef *methods,
const char *doc, PyObject *self,
int apiver);
ANSI-fication of the sources -- remove Py_PROTO!
2000-07-08 17:25:55 +00:00
The great renaming, phase two: all header files have been updated to use the new names exclusively, and the linker will see the new names. Files that import "Python.h" also only see the new names. Files that import "allobjects.h" will continue to be able to use the old names, due to the inclusion (in allobjects.h) of "rename2.h".
1995-01-12 11:45:45 +00:00
#define Py_InitModule(name, methods) \
Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
PYTHON_API_VERSION)
* Added support for X11 modules. * Makefile: change location of FORMS library. * posixmodule.c: turn #if 0 into #ifdef MSDOS (stuff in unistd.h or not) * Almost all .h files: added CPP magic to avoid duplicate inclusions and to support inclusion from C++.
1993-07-28 09:05:47 +00:00
Define new macro Py_InitModule3(name, methods, doc) which calls Py_InitModule4() with appropriate arguments.
1998-06-27 18:21:59 +00:00
#define Py_InitModule3(name, methods, doc) \
Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
PYTHON_API_VERSION)
Excise DL_EXPORT from Include. Thanks to Skip Montanaro and Kalle Svensson for the patches.
2002-08-12 07:21:58 +00:00
PyAPI_DATA(char *) _Py_PackageContext;
Add declaration for _Py_PackageContext -- needed to fix importing of shared libraries from inside packages.
1997-11-19 18:51:35 +00:00
* Added support for X11 modules. * Makefile: change location of FORMS library. * posixmodule.c: turn #if 0 into #ifdef MSDOS (stuff in unistd.h or not) * Almost all .h files: added CPP magic to avoid duplicate inclusions and to support inclusion from C++.
1993-07-28 09:05:47 +00:00
#ifdef __cplusplus
}
#endif
#endif /* !Py_MODSUPPORT_H */