mirror of
https://github.com/python/cpython.git
synced 2025-11-03 23:21:29 +00:00
da6760bdf5
Change the declaration of the keywords parameter in functions PyArg_ParseTupleAndKeywords() and PyArg_VaParseTupleAndKeywords() from `char **` to `char * const *` in C and `const char * const *` in C++. It makes these functions compatible with argument of type `const char * const *`, `const char **` or `char * const *` in C++ and `char * const *` in C without explicit type cast. Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
140 lines
5.4 KiB
C
140 lines
5.4 KiB
C
// Module support interface
|
|
|
|
#ifndef Py_MODSUPPORT_H
|
|
#define Py_MODSUPPORT_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
PyAPI_FUNC(int) PyArg_Parse(PyObject *, const char *, ...);
|
|
PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...);
|
|
PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
|
|
const char *, PY_CXX_CONST char * const *, ...);
|
|
PyAPI_FUNC(int) PyArg_VaParse(PyObject *, const char *, va_list);
|
|
PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
|
|
const char *, PY_CXX_CONST char * const *, va_list);
|
|
|
|
PyAPI_FUNC(int) PyArg_ValidateKeywordArguments(PyObject *);
|
|
PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, const char *, Py_ssize_t, Py_ssize_t, ...);
|
|
PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...);
|
|
PyAPI_FUNC(PyObject *) Py_VaBuildValue(const char *, va_list);
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x030a0000
|
|
// Add an attribute with name 'name' and value 'obj' to the module 'mod.
|
|
// On success, return 0.
|
|
// On error, raise an exception and return -1.
|
|
PyAPI_FUNC(int) PyModule_AddObjectRef(PyObject *mod, const char *name, PyObject *value);
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x030d0000
|
|
// Similar to PyModule_AddObjectRef() but steal a reference to 'value'.
|
|
PyAPI_FUNC(int) PyModule_Add(PyObject *mod, const char *name, PyObject *value);
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
// Similar to PyModule_AddObjectRef() and PyModule_Add() but steal
|
|
// a reference to 'value' on success and only on success.
|
|
// Errorprone. Should not be used in new code.
|
|
PyAPI_FUNC(int) PyModule_AddObject(PyObject *mod, const char *, PyObject *value);
|
|
|
|
PyAPI_FUNC(int) PyModule_AddIntConstant(PyObject *, const char *, long);
|
|
PyAPI_FUNC(int) PyModule_AddStringConstant(PyObject *, const char *, const char *);
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03090000
|
|
/* New in 3.9 */
|
|
PyAPI_FUNC(int) PyModule_AddType(PyObject *module, PyTypeObject *type);
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
#define PyModule_AddIntMacro(m, c) PyModule_AddIntConstant((m), #c, (c))
|
|
#define PyModule_AddStringMacro(m, c) PyModule_AddStringConstant((m), #c, (c))
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03050000
|
|
/* New in 3.5 */
|
|
PyAPI_FUNC(int) PyModule_SetDocString(PyObject *, const char *);
|
|
PyAPI_FUNC(int) PyModule_AddFunctions(PyObject *, PyMethodDef *);
|
|
PyAPI_FUNC(int) PyModule_ExecDef(PyObject *module, PyModuleDef *def);
|
|
#endif
|
|
|
|
#define Py_CLEANUP_SUPPORTED 0x20000
|
|
|
|
#define PYTHON_API_VERSION 1013
|
|
#define PYTHON_API_STRING "1013"
|
|
/* The API version is maintained (independently from the Python version)
|
|
so we can detect mismatches between the interpreter and dynamically
|
|
loaded modules. These are diagnosed by an error message but
|
|
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.
|
|
|
|
The symbol PYTHON_API_STRING defines the same value as a string
|
|
literal. *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
|
|
|
|
Please add a line or two to the top of this log for each API
|
|
version change:
|
|
|
|
22-Feb-2006 MvL 1013 PEP 353 - long indices for sequence lengths
|
|
|
|
19-Aug-2002 GvR 1012 Changes to string object struct for
|
|
interning changes, saving 3 bytes.
|
|
|
|
17-Jul-2001 GvR 1011 Descr-branch, just to be on the safe side
|
|
|
|
25-Jan-2001 FLD 1010 Parameters added to PyCode_New() and
|
|
PyFrame_New(); Python 2.1a2
|
|
|
|
14-Mar-2000 GvR 1009 Unicode API added
|
|
|
|
3-Jan-1999 GvR 1007 Decided to change back! (Don't reuse 1008!)
|
|
|
|
3-Dec-1998 GvR 1008 Python 1.5.2b1
|
|
|
|
18-Jan-1997 GvR 1007 string interning and other speedups
|
|
|
|
11-Oct-1996 GvR renamed Py_Ellipses to Py_Ellipsis :-(
|
|
|
|
30-Jul-1996 GvR Slice and ellipses syntax added
|
|
|
|
23-Jul-1996 GvR For 1.4 -- better safe than sorry this time :-)
|
|
|
|
7-Nov-1995 GvR Keyword arguments (should've been done at 1.3 :-( )
|
|
|
|
10-Jan-1995 GvR Renamed globals to new naming scheme
|
|
|
|
9-Jan-1995 GvR Initial version (incompatible with older API)
|
|
*/
|
|
|
|
/* The PYTHON_ABI_VERSION is introduced in PEP 384. For the lifetime of
|
|
Python 3, it will stay at the value of 3; changes to the limited API
|
|
must be performed in a strictly backwards-compatible manner. */
|
|
#define PYTHON_ABI_VERSION 3
|
|
#define PYTHON_ABI_STRING "3"
|
|
|
|
PyAPI_FUNC(PyObject *) PyModule_Create2(PyModuleDef*, int apiver);
|
|
|
|
#ifdef Py_LIMITED_API
|
|
#define PyModule_Create(module) \
|
|
PyModule_Create2((module), PYTHON_ABI_VERSION)
|
|
#else
|
|
#define PyModule_Create(module) \
|
|
PyModule_Create2((module), PYTHON_API_VERSION)
|
|
#endif
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03050000
|
|
/* New in 3.5 */
|
|
PyAPI_FUNC(PyObject *) PyModule_FromDefAndSpec2(PyModuleDef *def,
|
|
PyObject *spec,
|
|
int module_api_version);
|
|
|
|
#ifdef Py_LIMITED_API
|
|
#define PyModule_FromDefAndSpec(module, spec) \
|
|
PyModule_FromDefAndSpec2((module), (spec), PYTHON_ABI_VERSION)
|
|
#else
|
|
#define PyModule_FromDefAndSpec(module, spec) \
|
|
PyModule_FromDefAndSpec2((module), (spec), PYTHON_API_VERSION)
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
#endif /* New in 3.5 */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_MODSUPPORT_H */
|