blob: 73bbb3fe54e5d0ddcf415931b0a035c48ca53fee [file] [log] [blame]
Guido van Rossum32d34c82001-09-20 21:45:26 +00001/* Descriptors */
Martin v. Löwis522cf1f2002-03-30 08:57:12 +00002#ifndef Py_DESCROBJECT_H
3#define Py_DESCROBJECT_H
4#ifdef __cplusplus
5extern "C" {
6#endif
Tim Peters6d6c1a32001-08-02 04:15:00 +00007
8typedef PyObject *(*getter)(PyObject *, void *);
9typedef int (*setter)(PyObject *, PyObject *, void *);
10
Guido van Rossum32d34c82001-09-20 21:45:26 +000011typedef struct PyGetSetDef {
Serhiy Storchaka007d7ff2016-11-22 07:58:08 +020012 const char *name;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000013 getter get;
14 setter set;
Serhiy Storchaka007d7ff2016-11-22 07:58:08 +020015 const char *doc;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000016 void *closure;
Guido van Rossum32d34c82001-09-20 21:45:26 +000017} PyGetSetDef;
Tim Peters6d6c1a32001-08-02 04:15:00 +000018
Martin v. Löwis4d0d4712010-12-03 20:14:31 +000019#ifndef Py_LIMITED_API
Tim Peters6d6c1a32001-08-02 04:15:00 +000020typedef PyObject *(*wrapperfunc)(PyObject *self, PyObject *args,
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000021 void *wrapped);
Tim Peters6d6c1a32001-08-02 04:15:00 +000022
Guido van Rossumc8e56452001-10-22 00:43:43 +000023typedef PyObject *(*wrapperfunc_kwds)(PyObject *self, PyObject *args,
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000024 void *wrapped, PyObject *kwds);
Guido van Rossumc8e56452001-10-22 00:43:43 +000025
Tim Peters6d6c1a32001-08-02 04:15:00 +000026struct wrapperbase {
Serhiy Storchaka007d7ff2016-11-22 07:58:08 +020027 const char *name;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000028 int offset;
29 void *function;
30 wrapperfunc wrapper;
Serhiy Storchaka007d7ff2016-11-22 07:58:08 +020031 const char *doc;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000032 int flags;
33 PyObject *name_strobj;
Tim Peters6d6c1a32001-08-02 04:15:00 +000034};
35
Guido van Rossumc8e56452001-10-22 00:43:43 +000036/* Flags for above struct */
37#define PyWrapperFlag_KEYWORDS 1 /* wrapper function takes keyword args */
38
Guido van Rossumf4593e02001-10-03 12:09:30 +000039/* Various kinds of descriptor objects */
40
Guido van Rossumf4593e02001-10-03 12:09:30 +000041typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000042 PyObject_HEAD
43 PyTypeObject *d_type;
44 PyObject *d_name;
Antoine Pitrou9d574812011-12-12 13:47:25 +010045 PyObject *d_qualname;
Guido van Rossumf4593e02001-10-03 12:09:30 +000046} PyDescrObject;
47
Alexandre Vassalotti2db046d2009-07-22 03:56:36 +000048#define PyDescr_COMMON PyDescrObject d_common
49
50#define PyDescr_TYPE(x) (((PyDescrObject *)(x))->d_type)
51#define PyDescr_NAME(x) (((PyDescrObject *)(x))->d_name)
52
Guido van Rossumf4593e02001-10-03 12:09:30 +000053typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000054 PyDescr_COMMON;
55 PyMethodDef *d_method;
Guido van Rossumf4593e02001-10-03 12:09:30 +000056} PyMethodDescrObject;
57
58typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000059 PyDescr_COMMON;
60 struct PyMemberDef *d_member;
Guido van Rossumf4593e02001-10-03 12:09:30 +000061} PyMemberDescrObject;
62
63typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000064 PyDescr_COMMON;
65 PyGetSetDef *d_getset;
Guido van Rossumf4593e02001-10-03 12:09:30 +000066} PyGetSetDescrObject;
67
68typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000069 PyDescr_COMMON;
70 struct wrapperbase *d_base;
71 void *d_wrapped; /* This can be any function pointer */
Guido van Rossumf4593e02001-10-03 12:09:30 +000072} PyWrapperDescrObject;
Martin v. Löwis4d0d4712010-12-03 20:14:31 +000073#endif /* Py_LIMITED_API */
Guido van Rossumf4593e02001-10-03 12:09:30 +000074
Christian Heimesa22e8bd2007-11-29 22:35:39 +000075PyAPI_DATA(PyTypeObject) PyClassMethodDescr_Type;
76PyAPI_DATA(PyTypeObject) PyGetSetDescr_Type;
77PyAPI_DATA(PyTypeObject) PyMemberDescr_Type;
78PyAPI_DATA(PyTypeObject) PyMethodDescr_Type;
Mark Hammond91a681d2002-08-12 07:21:58 +000079PyAPI_DATA(PyTypeObject) PyWrapperDescr_Type;
Christian Heimesa22e8bd2007-11-29 22:35:39 +000080PyAPI_DATA(PyTypeObject) PyDictProxy_Type;
Serhiy Storchaka9fab79b2016-09-11 11:03:14 +030081#ifndef Py_LIMITED_API
Benjamin Petersoneff61f62011-09-01 16:32:31 -040082PyAPI_DATA(PyTypeObject) _PyMethodWrapper_Type;
Serhiy Storchaka9fab79b2016-09-11 11:03:14 +030083#endif /* Py_LIMITED_API */
Guido van Rossumf4593e02001-10-03 12:09:30 +000084
Mark Hammond91a681d2002-08-12 07:21:58 +000085PyAPI_FUNC(PyObject *) PyDescr_NewMethod(PyTypeObject *, PyMethodDef *);
Tim Petersbca1cbc2002-12-09 22:56:13 +000086PyAPI_FUNC(PyObject *) PyDescr_NewClassMethod(PyTypeObject *, PyMethodDef *);
Martin v. Löwis4d0d4712010-12-03 20:14:31 +000087struct PyMemberDef; /* forward declaration for following prototype */
Mark Hammond91a681d2002-08-12 07:21:58 +000088PyAPI_FUNC(PyObject *) PyDescr_NewMember(PyTypeObject *,
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000089 struct PyMemberDef *);
Mark Hammond91a681d2002-08-12 07:21:58 +000090PyAPI_FUNC(PyObject *) PyDescr_NewGetSet(PyTypeObject *,
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000091 struct PyGetSetDef *);
Martin v. Löwis4d0d4712010-12-03 20:14:31 +000092#ifndef Py_LIMITED_API
INADA Naoki5566bbb2017-02-03 07:43:03 +090093
94PyAPI_FUNC(PyObject *) _PyMethodDescr_FastCallKeywords(
Serhiy Storchakaa5552f02017-12-15 13:11:11 +020095 PyObject *descrobj, PyObject *const *stack, Py_ssize_t nargs, PyObject *kwnames);
Mark Hammond91a681d2002-08-12 07:21:58 +000096PyAPI_FUNC(PyObject *) PyDescr_NewWrapper(PyTypeObject *,
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000097 struct wrapperbase *, void *);
Christian Heimes90aa7642007-12-19 02:45:37 +000098#define PyDescr_IsData(d) (Py_TYPE(d)->tp_descr_set != NULL)
Martin v. Löwis4d0d4712010-12-03 20:14:31 +000099#endif
Tim Peters6d6c1a32001-08-02 04:15:00 +0000100
Mark Hammond91a681d2002-08-12 07:21:58 +0000101PyAPI_FUNC(PyObject *) PyDictProxy_New(PyObject *);
102PyAPI_FUNC(PyObject *) PyWrapper_New(PyObject *, PyObject *);
Guido van Rossum29a62dd2001-08-23 21:40:38 +0000103
104
Mark Hammond91a681d2002-08-12 07:21:58 +0000105PyAPI_DATA(PyTypeObject) PyProperty_Type;
Martin v. Löwis522cf1f2002-03-30 08:57:12 +0000106#ifdef __cplusplus
107}
108#endif
109#endif /* !Py_DESCROBJECT_H */
110