Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 1 | /*********************************************************** |
Guido van Rossum | 6610ad9 | 1995-01-04 19:07:38 +0000 | [diff] [blame] | 2 | Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam, |
| 3 | The Netherlands. |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 4 | |
| 5 | All Rights Reserved |
| 6 | |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 7 | Permission to use, copy, modify, and distribute this software and its |
| 8 | documentation for any purpose and without fee is hereby granted, |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 9 | provided that the above copyright notice appear in all copies and that |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 10 | both that copyright notice and this permission notice appear in |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 11 | supporting documentation, and that the names of Stichting Mathematisch |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 12 | Centrum or CWI or Corporation for National Research Initiatives or |
| 13 | CNRI not be used in advertising or publicity pertaining to |
| 14 | distribution of the software without specific, written prior |
| 15 | permission. |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 16 | |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 17 | While CWI is the initial source for this software, a modified version |
| 18 | is made available by the Corporation for National Research Initiatives |
| 19 | (CNRI) at the Internet address ftp://ftp.python.org. |
| 20 | |
| 21 | STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH |
| 22 | REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF |
| 23 | MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH |
| 24 | CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL |
| 25 | DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR |
| 26 | PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER |
| 27 | TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR |
| 28 | PERFORMANCE OF THIS SOFTWARE. |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 29 | |
| 30 | ******************************************************************/ |
| 31 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 32 | /* Method object implementation */ |
| 33 | |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 34 | #include "allobjects.h" |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 35 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 36 | #include "token.h" |
| 37 | |
| 38 | typedef struct { |
| 39 | OB_HEAD |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 40 | struct methodlist *m_ml; |
Guido van Rossum | c060229 | 1991-12-16 13:07:24 +0000 | [diff] [blame] | 41 | object *m_self; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 42 | } methodobject; |
| 43 | |
| 44 | object * |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 45 | newmethodobject(ml, self) |
| 46 | struct methodlist *ml; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 47 | object *self; |
| 48 | { |
| 49 | methodobject *op = NEWOBJ(methodobject, &Methodtype); |
| 50 | if (op != NULL) { |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 51 | op->m_ml = ml; |
| 52 | XINCREF(self); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 53 | op->m_self = self; |
| 54 | } |
| 55 | return (object *)op; |
| 56 | } |
| 57 | |
| 58 | method |
| 59 | getmethod(op) |
| 60 | object *op; |
| 61 | { |
| 62 | if (!is_methodobject(op)) { |
Guido van Rossum | 2a9096b | 1990-10-21 22:15:08 +0000 | [diff] [blame] | 63 | err_badcall(); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 64 | return NULL; |
| 65 | } |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 66 | return ((methodobject *)op) -> m_ml -> ml_meth; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 67 | } |
| 68 | |
| 69 | object * |
| 70 | getself(op) |
| 71 | object *op; |
| 72 | { |
| 73 | if (!is_methodobject(op)) { |
Guido van Rossum | 2a9096b | 1990-10-21 22:15:08 +0000 | [diff] [blame] | 74 | err_badcall(); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 75 | return NULL; |
| 76 | } |
| 77 | return ((methodobject *)op) -> m_self; |
| 78 | } |
| 79 | |
Guido van Rossum | c060229 | 1991-12-16 13:07:24 +0000 | [diff] [blame] | 80 | int |
Guido van Rossum | a83f270 | 1995-07-26 18:07:32 +0000 | [diff] [blame] | 81 | getflags(op) |
Guido van Rossum | c060229 | 1991-12-16 13:07:24 +0000 | [diff] [blame] | 82 | object *op; |
| 83 | { |
| 84 | if (!is_methodobject(op)) { |
| 85 | err_badcall(); |
| 86 | return -1; |
| 87 | } |
Guido van Rossum | a83f270 | 1995-07-26 18:07:32 +0000 | [diff] [blame] | 88 | return ((methodobject *)op) -> m_ml -> ml_flags; |
Guido van Rossum | c060229 | 1991-12-16 13:07:24 +0000 | [diff] [blame] | 89 | } |
| 90 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 91 | /* Methods (the standard built-in methods, that is) */ |
| 92 | |
| 93 | static void |
| 94 | meth_dealloc(m) |
| 95 | methodobject *m; |
| 96 | { |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 97 | XDECREF(m->m_self); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 98 | free((char *)m); |
| 99 | } |
| 100 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 101 | static object * |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 102 | meth_getattr(m, name) |
| 103 | methodobject *m; |
| 104 | char *name; |
| 105 | { |
| 106 | if (strcmp(name, "__name__") == 0) { |
| 107 | return newstringobject(m->m_ml->ml_name); |
| 108 | } |
| 109 | if (strcmp(name, "__doc__") == 0) { |
| 110 | char *doc = m->m_ml->ml_doc; |
| 111 | if (doc != NULL) |
| 112 | return newstringobject(doc); |
| 113 | INCREF(None); |
| 114 | return None; |
| 115 | } |
| 116 | if (strcmp(name, "__self__") == 0) { |
Guido van Rossum | 10393b1 | 1995-01-10 10:39:49 +0000 | [diff] [blame] | 117 | object *self; |
| 118 | if (getrestricted()) { |
| 119 | err_setstr(RuntimeError, |
| 120 | "method.__self__ not accessible in restricted mode"); |
| 121 | return NULL; |
| 122 | } |
| 123 | self = m->m_self; |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 124 | if (self == NULL) |
| 125 | self = None; |
| 126 | INCREF(self); |
| 127 | return self; |
| 128 | } |
| 129 | if (strcmp(name, "__members__") == 0) { |
| 130 | return mkvalue("[sss]", "__doc__", "__name__", "__self__"); |
| 131 | } |
| 132 | err_setstr(AttributeError, name); |
| 133 | return NULL; |
| 134 | } |
| 135 | |
| 136 | static object * |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 137 | meth_repr(m) |
| 138 | methodobject *m; |
| 139 | { |
| 140 | char buf[200]; |
| 141 | if (m->m_self == NULL) |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 142 | sprintf(buf, "<built-in function %.80s>", m->m_ml->ml_name); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 143 | else |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 144 | sprintf(buf, |
Guido van Rossum | b3f7258 | 1993-05-21 19:56:10 +0000 | [diff] [blame] | 145 | "<built-in method %.80s of %.80s object at %lx>", |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 146 | m->m_ml->ml_name, m->m_self->ob_type->tp_name, |
Guido van Rossum | 9bfef44 | 1993-03-29 10:43:31 +0000 | [diff] [blame] | 147 | (long)m->m_self); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 148 | return newstringobject(buf); |
| 149 | } |
| 150 | |
Guido van Rossum | 9bfef44 | 1993-03-29 10:43:31 +0000 | [diff] [blame] | 151 | static int |
| 152 | meth_compare(a, b) |
| 153 | methodobject *a, *b; |
| 154 | { |
| 155 | if (a->m_self != b->m_self) |
| 156 | return cmpobject(a->m_self, b->m_self); |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 157 | if (a->m_ml->ml_meth == b->m_ml->ml_meth) |
Guido van Rossum | 9bfef44 | 1993-03-29 10:43:31 +0000 | [diff] [blame] | 158 | return 0; |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 159 | if (strcmp(a->m_ml->ml_name, b->m_ml->ml_name) < 0) |
Guido van Rossum | 9bfef44 | 1993-03-29 10:43:31 +0000 | [diff] [blame] | 160 | return -1; |
| 161 | else |
| 162 | return 1; |
| 163 | } |
| 164 | |
| 165 | static long |
| 166 | meth_hash(a) |
| 167 | methodobject *a; |
| 168 | { |
Guido van Rossum | d7047b3 | 1995-01-02 19:07:15 +0000 | [diff] [blame] | 169 | long x; |
Guido van Rossum | 9bfef44 | 1993-03-29 10:43:31 +0000 | [diff] [blame] | 170 | if (a->m_self == NULL) |
| 171 | x = 0; |
| 172 | else { |
| 173 | x = hashobject(a->m_self); |
| 174 | if (x == -1) |
| 175 | return -1; |
| 176 | } |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 177 | return x ^ (long) a->m_ml->ml_meth; |
Guido van Rossum | 9bfef44 | 1993-03-29 10:43:31 +0000 | [diff] [blame] | 178 | } |
| 179 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 180 | typeobject Methodtype = { |
| 181 | OB_HEAD_INIT(&Typetype) |
| 182 | 0, |
Guido van Rossum | 7066dd7 | 1992-09-17 17:54:56 +0000 | [diff] [blame] | 183 | "builtin_function_or_method", |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 184 | sizeof(methodobject), |
| 185 | 0, |
Guido van Rossum | 1d5735e | 1994-08-30 08:27:36 +0000 | [diff] [blame] | 186 | (destructor)meth_dealloc, /*tp_dealloc*/ |
Guido van Rossum | 7066dd7 | 1992-09-17 17:54:56 +0000 | [diff] [blame] | 187 | 0, /*tp_print*/ |
Guido van Rossum | cab650d | 1995-01-07 12:34:58 +0000 | [diff] [blame] | 188 | (getattrfunc)meth_getattr, /*tp_getattr*/ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 189 | 0, /*tp_setattr*/ |
Guido van Rossum | 1d5735e | 1994-08-30 08:27:36 +0000 | [diff] [blame] | 190 | (cmpfunc)meth_compare, /*tp_compare*/ |
| 191 | (reprfunc)meth_repr, /*tp_repr*/ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 192 | 0, /*tp_as_number*/ |
| 193 | 0, /*tp_as_sequence*/ |
| 194 | 0, /*tp_as_mapping*/ |
Guido van Rossum | 1d5735e | 1994-08-30 08:27:36 +0000 | [diff] [blame] | 195 | (hashfunc)meth_hash, /*tp_hash*/ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 196 | }; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 197 | |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 198 | /* List all methods in a chain -- helper for findmethodinchain */ |
Guido van Rossum | e9c430f | 1991-10-20 20:21:15 +0000 | [diff] [blame] | 199 | |
| 200 | static object * |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 201 | listmethodchain(chain) |
| 202 | struct methodchain *chain; |
Guido van Rossum | e9c430f | 1991-10-20 20:21:15 +0000 | [diff] [blame] | 203 | { |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 204 | struct methodchain *c; |
| 205 | struct methodlist *ml; |
Guido van Rossum | e9c430f | 1991-10-20 20:21:15 +0000 | [diff] [blame] | 206 | int i, n; |
| 207 | object *v; |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 208 | |
| 209 | n = 0; |
| 210 | for (c = chain; c != NULL; c = c->link) { |
| 211 | for (ml = c->methods; ml->ml_name != NULL; ml++) |
| 212 | n++; |
| 213 | } |
Guido van Rossum | e9c430f | 1991-10-20 20:21:15 +0000 | [diff] [blame] | 214 | v = newlistobject(n); |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 215 | if (v == NULL) |
| 216 | return NULL; |
| 217 | i = 0; |
| 218 | for (c = chain; c != NULL; c = c->link) { |
| 219 | for (ml = c->methods; ml->ml_name != NULL; ml++) { |
| 220 | setlistitem(v, i, newstringobject(ml->ml_name)); |
| 221 | i++; |
Guido van Rossum | e9c430f | 1991-10-20 20:21:15 +0000 | [diff] [blame] | 222 | } |
| 223 | } |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 224 | if (err_occurred()) { |
| 225 | DECREF(v); |
| 226 | return NULL; |
| 227 | } |
| 228 | sortlist(v); |
Guido van Rossum | e9c430f | 1991-10-20 20:21:15 +0000 | [diff] [blame] | 229 | return v; |
| 230 | } |
| 231 | |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 232 | /* Find a method in a method chain */ |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 233 | |
| 234 | object * |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 235 | findmethodinchain(chain, self, name) |
| 236 | struct methodchain *chain; |
| 237 | object *self; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 238 | char *name; |
| 239 | { |
Guido van Rossum | e9c430f | 1991-10-20 20:21:15 +0000 | [diff] [blame] | 240 | if (strcmp(name, "__methods__") == 0) |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 241 | return listmethodchain(chain); |
| 242 | while (chain != NULL) { |
| 243 | struct methodlist *ml = chain->methods; |
| 244 | for (; ml->ml_name != NULL; ml++) { |
| 245 | if (name[0] == ml->ml_name[0] && |
| 246 | strcmp(name+1, ml->ml_name+1) == 0) |
| 247 | return newmethodobject(ml, self); |
| 248 | } |
| 249 | chain = chain->link; |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 250 | } |
Guido van Rossum | bd3a2e6 | 1991-12-10 13:58:49 +0000 | [diff] [blame] | 251 | err_setstr(AttributeError, name); |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 252 | return NULL; |
| 253 | } |
Guido van Rossum | 6978503 | 1995-01-26 22:58:48 +0000 | [diff] [blame] | 254 | |
| 255 | /* Find a method in a single method list */ |
| 256 | |
| 257 | object * |
| 258 | findmethod(methods, self, name) |
| 259 | struct methodlist *methods; |
| 260 | object *self; |
| 261 | char *name; |
| 262 | { |
| 263 | struct methodchain chain; |
| 264 | chain.methods = methods; |
| 265 | chain.link = NULL; |
| 266 | return findmethodinchain(&chain, self, name); |
| 267 | } |