Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 1 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 2 | /* Class object interface */ |
| 3 | |
Guido van Rossum | b3f7258 | 1993-05-21 19:56:10 +0000 | [diff] [blame] | 4 | /* Revealing some structures (not for general use) */ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 5 | |
Fred Drake | ea9cb5a | 2000-07-09 00:20:36 +0000 | [diff] [blame] | 6 | #ifndef Py_CLASSOBJECT_H |
| 7 | #define Py_CLASSOBJECT_H |
| 8 | #ifdef __cplusplus |
| 9 | extern "C" { |
| 10 | #endif |
| 11 | |
Guido van Rossum | 81daa32 | 1993-05-20 14:24:46 +0000 | [diff] [blame] | 12 | typedef struct { |
Fred Drake | ea9cb5a | 2000-07-09 00:20:36 +0000 | [diff] [blame] | 13 | PyObject_HEAD |
| 14 | PyObject *cl_bases; /* A tuple of class objects */ |
| 15 | PyObject *cl_dict; /* A dictionary */ |
| 16 | PyObject *cl_name; /* A string */ |
| 17 | /* The following three are functions or NULL */ |
| 18 | PyObject *cl_getattr; |
| 19 | PyObject *cl_setattr; |
| 20 | PyObject *cl_delattr; |
Guido van Rossum | caa6380 | 1995-01-12 11:45:45 +0000 | [diff] [blame] | 21 | } PyClassObject; |
Guido van Rossum | 81daa32 | 1993-05-20 14:24:46 +0000 | [diff] [blame] | 22 | |
Guido van Rossum | b3f7258 | 1993-05-21 19:56:10 +0000 | [diff] [blame] | 23 | typedef struct { |
Fred Drake | ea9cb5a | 2000-07-09 00:20:36 +0000 | [diff] [blame] | 24 | PyObject_HEAD |
| 25 | PyClassObject *in_class; /* The class object */ |
| 26 | PyObject *in_dict; /* A dictionary */ |
Fred Drake | 41deb1e | 2001-02-01 05:27:45 +0000 | [diff] [blame] | 27 | PyObject *in_weakreflist; /* List of weak references */ |
Guido van Rossum | caa6380 | 1995-01-12 11:45:45 +0000 | [diff] [blame] | 28 | } PyInstanceObject; |
Guido van Rossum | b3f7258 | 1993-05-21 19:56:10 +0000 | [diff] [blame] | 29 | |
Guido van Rossum | d4ba73c | 1998-07-10 15:46:33 +0000 | [diff] [blame] | 30 | typedef struct { |
Fred Drake | ea9cb5a | 2000-07-09 00:20:36 +0000 | [diff] [blame] | 31 | PyObject_HEAD |
| 32 | PyObject *im_func; /* The callable object implementing the method */ |
| 33 | PyObject *im_self; /* The instance it is bound to, or NULL */ |
Guido van Rossum | 301d0f8 | 2001-12-07 21:54:33 +0000 | [diff] [blame] | 34 | PyObject *im_class; /* The class that asked for the method */ |
Fred Drake | 6a1c87d | 2001-03-23 04:17:58 +0000 | [diff] [blame] | 35 | PyObject *im_weakreflist; /* List of weak references */ |
Guido van Rossum | d4ba73c | 1998-07-10 15:46:33 +0000 | [diff] [blame] | 36 | } PyMethodObject; |
| 37 | |
Mark Hammond | 91a681d | 2002-08-12 07:21:58 +0000 | [diff] [blame] | 38 | PyAPI_DATA(PyTypeObject) PyClass_Type, PyInstance_Type, PyMethod_Type; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 39 | |
Guido van Rossum | caa6380 | 1995-01-12 11:45:45 +0000 | [diff] [blame] | 40 | #define PyClass_Check(op) ((op)->ob_type == &PyClass_Type) |
| 41 | #define PyInstance_Check(op) ((op)->ob_type == &PyInstance_Type) |
| 42 | #define PyMethod_Check(op) ((op)->ob_type == &PyMethod_Type) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 43 | |
Mark Hammond | 91a681d | 2002-08-12 07:21:58 +0000 | [diff] [blame] | 44 | PyAPI_FUNC(PyObject *) PyClass_New(PyObject *, PyObject *, PyObject *); |
| 45 | PyAPI_FUNC(PyObject *) PyInstance_New(PyObject *, PyObject *, |
Fred Drake | ea9cb5a | 2000-07-09 00:20:36 +0000 | [diff] [blame] | 46 | PyObject *); |
Mark Hammond | 91a681d | 2002-08-12 07:21:58 +0000 | [diff] [blame] | 47 | PyAPI_FUNC(PyObject *) PyInstance_NewRaw(PyObject *, PyObject *); |
| 48 | PyAPI_FUNC(PyObject *) PyMethod_New(PyObject *, PyObject *, PyObject *); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 49 | |
Mark Hammond | 91a681d | 2002-08-12 07:21:58 +0000 | [diff] [blame] | 50 | PyAPI_FUNC(PyObject *) PyMethod_Function(PyObject *); |
| 51 | PyAPI_FUNC(PyObject *) PyMethod_Self(PyObject *); |
| 52 | PyAPI_FUNC(PyObject *) PyMethod_Class(PyObject *); |
Guido van Rossum | b479dc5 | 2001-09-05 22:52:50 +0000 | [diff] [blame] | 53 | |
Tim Peters | df875b9 | 2003-04-07 17:51:59 +0000 | [diff] [blame] | 54 | /* Look up attribute with name (a string) on instance object pinst, using |
| 55 | * only the instance and base class dicts. If a descriptor is found in |
| 56 | * a class dict, the descriptor is returned without calling it. |
| 57 | * Returns NULL if nothing found, else a borrowed reference to the |
| 58 | * value associated with name in the dict in which name was found. |
| 59 | * The point of this routine is that it never calls arbitrary Python |
| 60 | * code, so is always "safe": all it does is dict lookups. The function |
Tim Peters | f995cce | 2003-04-08 18:47:21 +0000 | [diff] [blame] | 61 | * can't fail, never sets an exception, and NULL is not an error (it just |
Tim Peters | df875b9 | 2003-04-07 17:51:59 +0000 | [diff] [blame] | 62 | * means "not found"). |
| 63 | */ |
Tim Peters | f995cce | 2003-04-08 18:47:21 +0000 | [diff] [blame] | 64 | PyAPI_FUNC(PyObject *) _PyInstance_Lookup(PyObject *pinst, PyObject *name); |
Tim Peters | df875b9 | 2003-04-07 17:51:59 +0000 | [diff] [blame] | 65 | |
Guido van Rossum | d4ba73c | 1998-07-10 15:46:33 +0000 | [diff] [blame] | 66 | /* Macros for direct access to these values. Type checks are *not* |
| 67 | done, so use with care. */ |
| 68 | #define PyMethod_GET_FUNCTION(meth) \ |
| 69 | (((PyMethodObject *)meth) -> im_func) |
| 70 | #define PyMethod_GET_SELF(meth) \ |
| 71 | (((PyMethodObject *)meth) -> im_self) |
| 72 | #define PyMethod_GET_CLASS(meth) \ |
| 73 | (((PyMethodObject *)meth) -> im_class) |
| 74 | |
Mark Hammond | 91a681d | 2002-08-12 07:21:58 +0000 | [diff] [blame] | 75 | PyAPI_FUNC(int) PyClass_IsSubclass(PyObject *, PyObject *); |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 76 | |
Thomas Wouters | dd8dbdb | 2000-08-24 20:09:45 +0000 | [diff] [blame] | 77 | |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 78 | #ifdef __cplusplus |
| 79 | } |
| 80 | #endif |
| 81 | #endif /* !Py_CLASSOBJECT_H */ |