blob: 13349cc7bb18928471bc339271ca96ff1a28e322 [file] [log] [blame]
Guido van Rossum3f5da241990-12-20 15:06:42 +00001/* Built-in functions */
2
Guido van Rossum79f25d91997-04-29 20:08:16 +00003#include "Python.h"
Martin v. Löwis618dc5e2008-03-30 20:03:44 +00004#include "Python-ast.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00005
6#include "node.h"
Jeremy Hylton3e0055f2005-10-20 19:59:25 +00007#include "code.h"
Guido van Rossum3f5da241990-12-20 15:06:42 +00008
Benjamin Petersonea281a52011-08-12 23:10:50 -05009#include "asdl.h"
10#include "ast.h"
11
Guido van Rossum6bf62da1997-04-11 20:37:35 +000012#include <ctype.h>
13
Victor Stinnerb744ba12010-05-15 12:27:16 +000014#ifdef HAVE_LANGINFO_H
15#include <langinfo.h> /* CODESET */
16#endif
17
Mark Hammond26cffde42001-05-14 12:17:34 +000018/* The default encoding used by the platform file system APIs
19 Can remain NULL for all platforms that don't have such a concept
Guido van Rossum00bc0e02007-10-15 02:52:41 +000020
21 Don't forget to modify PyUnicode_DecodeFSDefault() if you touch any of the
22 values for Py_FileSystemDefaultEncoding!
Mark Hammond26cffde42001-05-14 12:17:34 +000023*/
Victor Stinner99b95382011-07-04 14:23:54 +020024#ifdef HAVE_MBCS
Mark Hammond26cffde42001-05-14 12:17:34 +000025const char *Py_FileSystemDefaultEncoding = "mbcs";
Martin v. Löwis04dc25c2008-10-03 16:09:28 +000026int Py_HasFileSystemDefaultEncoding = 1;
Just van Rossumb9b8e9c2003-02-10 09:22:01 +000027#elif defined(__APPLE__)
28const char *Py_FileSystemDefaultEncoding = "utf-8";
Martin v. Löwis04dc25c2008-10-03 16:09:28 +000029int Py_HasFileSystemDefaultEncoding = 1;
Victor Stinnerd64e8a72011-07-04 13:48:30 +020030#else
Victor Stinnerb744ba12010-05-15 12:27:16 +000031const char *Py_FileSystemDefaultEncoding = NULL; /* set by initfsencoding() */
Martin v. Löwis04dc25c2008-10-03 16:09:28 +000032int Py_HasFileSystemDefaultEncoding = 0;
Mark Hammond26cffde42001-05-14 12:17:34 +000033#endif
Mark Hammondef8b6542001-05-13 08:04:26 +000034
Martin v. Löwisbd928fe2011-10-14 10:20:37 +020035_Py_IDENTIFIER(fileno);
36_Py_IDENTIFIER(flush);
Martin v. Löwisafe55bb2011-10-09 10:38:36 +020037
Guido van Rossum79f25d91997-04-29 20:08:16 +000038static PyObject *
Guido van Rossum52cc1d82007-03-18 15:41:51 +000039builtin___build_class__(PyObject *self, PyObject *args, PyObject *kwds)
40{
Nick Coghlande31b192011-10-23 22:04:16 +100041 PyObject *func, *name, *bases, *mkw, *meta, *winner, *prep, *ns, *cell;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000042 PyObject *cls = NULL;
Florent Xicluna4d46c2a2011-10-28 15:00:50 +020043 Py_ssize_t nargs;
Nick Coghlande31b192011-10-23 22:04:16 +100044 int isclass;
Martin v. Löwisbd928fe2011-10-14 10:20:37 +020045 _Py_IDENTIFIER(__prepare__);
Guido van Rossum52cc1d82007-03-18 15:41:51 +000046
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000047 assert(args != NULL);
48 if (!PyTuple_Check(args)) {
49 PyErr_SetString(PyExc_TypeError,
50 "__build_class__: args is not a tuple");
51 return NULL;
52 }
53 nargs = PyTuple_GET_SIZE(args);
54 if (nargs < 2) {
55 PyErr_SetString(PyExc_TypeError,
56 "__build_class__: not enough arguments");
57 return NULL;
58 }
59 func = PyTuple_GET_ITEM(args, 0); /* Better be callable */
60 name = PyTuple_GET_ITEM(args, 1);
61 if (!PyUnicode_Check(name)) {
62 PyErr_SetString(PyExc_TypeError,
63 "__build_class__: name is not a string");
64 return NULL;
65 }
66 bases = PyTuple_GetSlice(args, 2, nargs);
67 if (bases == NULL)
68 return NULL;
Guido van Rossum52cc1d82007-03-18 15:41:51 +000069
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000070 if (kwds == NULL) {
71 meta = NULL;
72 mkw = NULL;
73 }
74 else {
75 mkw = PyDict_Copy(kwds); /* Don't modify kwds passed in! */
76 if (mkw == NULL) {
77 Py_DECREF(bases);
78 return NULL;
Guido van Rossum52cc1d82007-03-18 15:41:51 +000079 }
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000080 meta = PyDict_GetItemString(mkw, "metaclass");
81 if (meta != NULL) {
82 Py_INCREF(meta);
83 if (PyDict_DelItemString(mkw, "metaclass") < 0) {
84 Py_DECREF(meta);
85 Py_DECREF(mkw);
86 Py_DECREF(bases);
87 return NULL;
88 }
Nick Coghlande31b192011-10-23 22:04:16 +100089 /* metaclass is explicitly given, check if it's indeed a class */
90 isclass = PyType_Check(meta);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000091 }
92 }
93 if (meta == NULL) {
Nick Coghlande31b192011-10-23 22:04:16 +100094 /* if there are no bases, use type: */
95 if (PyTuple_GET_SIZE(bases) == 0) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000096 meta = (PyObject *) (&PyType_Type);
Nick Coghlande31b192011-10-23 22:04:16 +100097 }
98 /* else get the type of the first base */
Antoine Pitrouf95a1b32010-05-09 15:52:27 +000099 else {
100 PyObject *base0 = PyTuple_GET_ITEM(bases, 0);
101 meta = (PyObject *) (base0->ob_type);
102 }
103 Py_INCREF(meta);
Nick Coghlande31b192011-10-23 22:04:16 +1000104 isclass = 1; /* meta is really a class */
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000105 }
Nick Coghlan9715d262011-10-23 22:36:42 +1000106
Nick Coghlande31b192011-10-23 22:04:16 +1000107 if (isclass) {
108 /* meta is really a class, so check for a more derived
109 metaclass, or possible metaclass conflicts: */
110 winner = (PyObject *)_PyType_CalculateMetaclass((PyTypeObject *)meta,
111 bases);
112 if (winner == NULL) {
113 Py_DECREF(meta);
114 Py_XDECREF(mkw);
115 Py_DECREF(bases);
116 return NULL;
117 }
118 if (winner != meta) {
119 Py_DECREF(meta);
120 meta = winner;
121 Py_INCREF(meta);
122 }
123 }
124 /* else: meta is not a class, so we cannot do the metaclass
125 calculation, so we will use the explicitly given object as it is */
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +0200126 prep = _PyObject_GetAttrId(meta, &PyId___prepare__);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000127 if (prep == NULL) {
128 if (PyErr_ExceptionMatches(PyExc_AttributeError)) {
129 PyErr_Clear();
130 ns = PyDict_New();
131 }
132 else {
133 Py_DECREF(meta);
134 Py_XDECREF(mkw);
135 Py_DECREF(bases);
136 return NULL;
137 }
138 }
139 else {
140 PyObject *pargs = PyTuple_Pack(2, name, bases);
141 if (pargs == NULL) {
142 Py_DECREF(prep);
143 Py_DECREF(meta);
144 Py_XDECREF(mkw);
145 Py_DECREF(bases);
146 return NULL;
147 }
148 ns = PyEval_CallObjectWithKeywords(prep, pargs, mkw);
149 Py_DECREF(pargs);
150 Py_DECREF(prep);
151 }
152 if (ns == NULL) {
153 Py_DECREF(meta);
154 Py_XDECREF(mkw);
155 Py_DECREF(bases);
156 return NULL;
157 }
158 cell = PyObject_CallFunctionObjArgs(func, ns, NULL);
159 if (cell != NULL) {
160 PyObject *margs;
161 margs = PyTuple_Pack(3, name, bases, ns);
162 if (margs != NULL) {
163 cls = PyEval_CallObjectWithKeywords(meta, margs, mkw);
164 Py_DECREF(margs);
165 }
166 if (cls != NULL && PyCell_Check(cell)) {
167 Py_INCREF(cls);
168 PyCell_SET(cell, cls);
169 }
170 Py_DECREF(cell);
171 }
172 Py_DECREF(ns);
173 Py_DECREF(meta);
174 Py_XDECREF(mkw);
175 Py_DECREF(bases);
176 return cls;
Guido van Rossum52cc1d82007-03-18 15:41:51 +0000177}
178
179PyDoc_STRVAR(build_class_doc,
180"__build_class__(func, name, *bases, metaclass=None, **kwds) -> class\n\
181\n\
182Internal helper function used by the class statement.");
183
184static PyObject *
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000185builtin___import__(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000186{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000187 static char *kwlist[] = {"name", "globals", "locals", "fromlist",
188 "level", 0};
Victor Stinnerfe93faf2011-03-14 15:54:52 -0400189 PyObject *name, *globals = NULL, *locals = NULL, *fromlist = NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000190 int level = -1;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000191
Victor Stinnerfe93faf2011-03-14 15:54:52 -0400192 if (!PyArg_ParseTupleAndKeywords(args, kwds, "U|OOOi:__import__",
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000193 kwlist, &name, &globals, &locals, &fromlist, &level))
194 return NULL;
Victor Stinnerfe93faf2011-03-14 15:54:52 -0400195 return PyImport_ImportModuleLevelObject(name, globals, locals,
196 fromlist, level);
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000197}
198
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000199PyDoc_STRVAR(import_doc,
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000200"__import__(name, globals={}, locals={}, fromlist=[], level=-1) -> module\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000201\n\
Brett Cannon5305a992010-09-27 21:08:38 +0000202Import a module. Because this function is meant for use by the Python\n\
203interpreter and not for general use it is better to use\n\
204importlib.import_module() to programmatically import a module.\n\
205\n\
206The globals argument is only used to determine the context;\n\
207they are not modified. The locals argument is unused. The fromlist\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000208should be a list of names to emulate ``from name import ...'', or an\n\
209empty list to emulate ``import name''.\n\
210When importing a module from a package, note that __import__('A.B', ...)\n\
211returns package A when fromlist is empty, but its submodule B when\n\
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000212fromlist is not empty. Level is used to determine whether to perform \n\
213absolute or relative imports. -1 is the original strategy of attempting\n\
214both absolute and relative imports, 0 is absolute, a positive number\n\
215is the number of parent directories to search relative to the current module.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000216
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000217
Guido van Rossum79f25d91997-04-29 20:08:16 +0000218static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000219builtin_abs(PyObject *self, PyObject *v)
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000220{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000221 return PyNumber_Absolute(v);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000222}
223
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000224PyDoc_STRVAR(abs_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000225"abs(number) -> number\n\
226\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000227Return the absolute value of the argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000228
Raymond Hettinger96229b12005-03-11 06:49:40 +0000229static PyObject *
230builtin_all(PyObject *self, PyObject *v)
231{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000232 PyObject *it, *item;
233 PyObject *(*iternext)(PyObject *);
234 int cmp;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000235
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000236 it = PyObject_GetIter(v);
237 if (it == NULL)
238 return NULL;
239 iternext = *Py_TYPE(it)->tp_iternext;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000240
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000241 for (;;) {
242 item = iternext(it);
243 if (item == NULL)
244 break;
245 cmp = PyObject_IsTrue(item);
246 Py_DECREF(item);
247 if (cmp < 0) {
248 Py_DECREF(it);
249 return NULL;
250 }
251 if (cmp == 0) {
252 Py_DECREF(it);
253 Py_RETURN_FALSE;
254 }
255 }
256 Py_DECREF(it);
257 if (PyErr_Occurred()) {
258 if (PyErr_ExceptionMatches(PyExc_StopIteration))
259 PyErr_Clear();
260 else
261 return NULL;
262 }
263 Py_RETURN_TRUE;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000264}
265
266PyDoc_STRVAR(all_doc,
267"all(iterable) -> bool\n\
268\n\
269Return True if bool(x) is True for all values x in the iterable.");
270
271static PyObject *
272builtin_any(PyObject *self, PyObject *v)
273{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000274 PyObject *it, *item;
275 PyObject *(*iternext)(PyObject *);
276 int cmp;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000277
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000278 it = PyObject_GetIter(v);
279 if (it == NULL)
280 return NULL;
281 iternext = *Py_TYPE(it)->tp_iternext;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000282
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000283 for (;;) {
284 item = iternext(it);
285 if (item == NULL)
286 break;
287 cmp = PyObject_IsTrue(item);
288 Py_DECREF(item);
289 if (cmp < 0) {
290 Py_DECREF(it);
291 return NULL;
292 }
293 if (cmp == 1) {
294 Py_DECREF(it);
295 Py_RETURN_TRUE;
296 }
297 }
298 Py_DECREF(it);
299 if (PyErr_Occurred()) {
300 if (PyErr_ExceptionMatches(PyExc_StopIteration))
301 PyErr_Clear();
302 else
303 return NULL;
304 }
305 Py_RETURN_FALSE;
Raymond Hettinger96229b12005-03-11 06:49:40 +0000306}
307
308PyDoc_STRVAR(any_doc,
309"any(iterable) -> bool\n\
310\n\
311Return True if bool(x) is True for any x in the iterable.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000312
Georg Brandl559e5d72008-06-11 18:37:52 +0000313static PyObject *
314builtin_ascii(PyObject *self, PyObject *v)
315{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000316 return PyObject_ASCII(v);
Georg Brandl559e5d72008-06-11 18:37:52 +0000317}
318
319PyDoc_STRVAR(ascii_doc,
320"ascii(object) -> string\n\
321\n\
322As repr(), return a string containing a printable representation of an\n\
323object, but escape the non-ASCII characters in the string returned by\n\
324repr() using \\x, \\u or \\U escapes. This generates a string similar\n\
325to that returned by repr() in Python 2.");
326
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000327
Guido van Rossum79f25d91997-04-29 20:08:16 +0000328static PyObject *
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000329builtin_bin(PyObject *self, PyObject *v)
330{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000331 return PyNumber_ToBase(v, 2);
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000332}
333
334PyDoc_STRVAR(bin_doc,
335"bin(number) -> string\n\
336\n\
Alexander Belopolsky12338ab2011-04-07 00:15:33 -0400337Return the binary representation of an integer.");
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000338
339
Antoine Pitroue71362d2010-11-27 22:00:11 +0000340static PyObject *
341builtin_callable(PyObject *self, PyObject *v)
342{
343 return PyBool_FromLong((long)PyCallable_Check(v));
344}
345
346PyDoc_STRVAR(callable_doc,
347"callable(object) -> bool\n\
348\n\
349Return whether the object is callable (i.e., some kind of function).\n\
350Note that classes are callable, as are instances of classes with a\n\
351__call__() method.");
352
353
Raymond Hettinger17301e92008-03-13 00:19:26 +0000354typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000355 PyObject_HEAD
356 PyObject *func;
357 PyObject *it;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000358} filterobject;
359
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000360static PyObject *
Raymond Hettinger17301e92008-03-13 00:19:26 +0000361filter_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000362{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000363 PyObject *func, *seq;
364 PyObject *it;
365 filterobject *lz;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000366
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000367 if (type == &PyFilter_Type && !_PyArg_NoKeywords("filter()", kwds))
368 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000369
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000370 if (!PyArg_UnpackTuple(args, "filter", 2, 2, &func, &seq))
371 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000372
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000373 /* Get iterator. */
374 it = PyObject_GetIter(seq);
375 if (it == NULL)
376 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000377
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000378 /* create filterobject structure */
379 lz = (filterobject *)type->tp_alloc(type, 0);
380 if (lz == NULL) {
381 Py_DECREF(it);
382 return NULL;
383 }
384 Py_INCREF(func);
385 lz->func = func;
386 lz->it = it;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000387
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000388 return (PyObject *)lz;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000389}
390
391static void
392filter_dealloc(filterobject *lz)
393{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000394 PyObject_GC_UnTrack(lz);
395 Py_XDECREF(lz->func);
396 Py_XDECREF(lz->it);
397 Py_TYPE(lz)->tp_free(lz);
Raymond Hettinger17301e92008-03-13 00:19:26 +0000398}
399
400static int
401filter_traverse(filterobject *lz, visitproc visit, void *arg)
402{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000403 Py_VISIT(lz->it);
404 Py_VISIT(lz->func);
405 return 0;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000406}
407
408static PyObject *
409filter_next(filterobject *lz)
410{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000411 PyObject *item;
412 PyObject *it = lz->it;
413 long ok;
414 PyObject *(*iternext)(PyObject *);
Raymond Hettinger17301e92008-03-13 00:19:26 +0000415
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000416 iternext = *Py_TYPE(it)->tp_iternext;
417 for (;;) {
418 item = iternext(it);
419 if (item == NULL)
420 return NULL;
Raymond Hettinger17301e92008-03-13 00:19:26 +0000421
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000422 if (lz->func == Py_None || lz->func == (PyObject *)&PyBool_Type) {
423 ok = PyObject_IsTrue(item);
424 } else {
425 PyObject *good;
426 good = PyObject_CallFunctionObjArgs(lz->func,
427 item, NULL);
428 if (good == NULL) {
429 Py_DECREF(item);
430 return NULL;
431 }
432 ok = PyObject_IsTrue(good);
433 Py_DECREF(good);
434 }
435 if (ok)
436 return item;
437 Py_DECREF(item);
438 }
Guido van Rossum12d12c51993-10-26 17:58:25 +0000439}
440
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000441PyDoc_STRVAR(filter_doc,
Georg Brandld11ae5d2008-05-16 13:27:32 +0000442"filter(function or None, iterable) --> filter object\n\
Guido van Rossumc1f779c2007-07-03 08:25:58 +0000443\n\
Georg Brandld11ae5d2008-05-16 13:27:32 +0000444Return an iterator yielding those items of iterable for which function(item)\n\
Raymond Hettinger17301e92008-03-13 00:19:26 +0000445is true. If function is None, return the items that are true.");
446
447PyTypeObject PyFilter_Type = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000448 PyVarObject_HEAD_INIT(&PyType_Type, 0)
449 "filter", /* tp_name */
450 sizeof(filterobject), /* tp_basicsize */
451 0, /* tp_itemsize */
452 /* methods */
453 (destructor)filter_dealloc, /* tp_dealloc */
454 0, /* tp_print */
455 0, /* tp_getattr */
456 0, /* tp_setattr */
457 0, /* tp_reserved */
458 0, /* tp_repr */
459 0, /* tp_as_number */
460 0, /* tp_as_sequence */
461 0, /* tp_as_mapping */
462 0, /* tp_hash */
463 0, /* tp_call */
464 0, /* tp_str */
465 PyObject_GenericGetAttr, /* tp_getattro */
466 0, /* tp_setattro */
467 0, /* tp_as_buffer */
468 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
469 Py_TPFLAGS_BASETYPE, /* tp_flags */
470 filter_doc, /* tp_doc */
471 (traverseproc)filter_traverse, /* tp_traverse */
472 0, /* tp_clear */
473 0, /* tp_richcompare */
474 0, /* tp_weaklistoffset */
475 PyObject_SelfIter, /* tp_iter */
476 (iternextfunc)filter_next, /* tp_iternext */
477 0, /* tp_methods */
478 0, /* tp_members */
479 0, /* tp_getset */
480 0, /* tp_base */
481 0, /* tp_dict */
482 0, /* tp_descr_get */
483 0, /* tp_descr_set */
484 0, /* tp_dictoffset */
485 0, /* tp_init */
486 PyType_GenericAlloc, /* tp_alloc */
487 filter_new, /* tp_new */
488 PyObject_GC_Del, /* tp_free */
Raymond Hettinger17301e92008-03-13 00:19:26 +0000489};
490
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000491
Eric Smith8c663262007-08-25 02:26:07 +0000492static PyObject *
493builtin_format(PyObject *self, PyObject *args)
494{
Christian Heimes94b7d3d2007-12-11 20:20:39 +0000495 PyObject *value;
Eric Smith8fd3eba2008-02-17 19:48:00 +0000496 PyObject *format_spec = NULL;
Eric Smith8c663262007-08-25 02:26:07 +0000497
Eric Smith8fd3eba2008-02-17 19:48:00 +0000498 if (!PyArg_ParseTuple(args, "O|U:format", &value, &format_spec))
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000499 return NULL;
Eric Smith8c663262007-08-25 02:26:07 +0000500
Eric Smith8fd3eba2008-02-17 19:48:00 +0000501 return PyObject_Format(value, format_spec);
Eric Smith8c663262007-08-25 02:26:07 +0000502}
503
Eric Smith8c663262007-08-25 02:26:07 +0000504PyDoc_STRVAR(format_doc,
Eric Smith81936692007-08-31 01:14:01 +0000505"format(value[, format_spec]) -> string\n\
Eric Smith8c663262007-08-25 02:26:07 +0000506\n\
Eric Smith81936692007-08-31 01:14:01 +0000507Returns value.__format__(format_spec)\n\
508format_spec defaults to \"\"");
509
Guido van Rossum7fcf2242007-05-04 17:43:11 +0000510static PyObject *
Walter Dörwalde7efd592007-06-05 20:07:21 +0000511builtin_chr(PyObject *self, PyObject *args)
Guido van Rossum09095f32000-03-10 23:00:52 +0000512{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000513 int x;
Guido van Rossum09095f32000-03-10 23:00:52 +0000514
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000515 if (!PyArg_ParseTuple(args, "i:chr", &x))
516 return NULL;
Fredrik Lundh0dcf67e2001-06-26 20:01:56 +0000517
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000518 return PyUnicode_FromOrdinal(x);
Guido van Rossum09095f32000-03-10 23:00:52 +0000519}
520
Victor Stinner63ab8752011-11-22 03:31:20 +0100521PyDoc_STRVAR(chr_doc,
Guido van Rossum84fc66d2007-05-03 17:18:26 +0000522"chr(i) -> Unicode character\n\
Guido van Rossum09095f32000-03-10 23:00:52 +0000523\n\
Victor Stinner63ab8752011-11-22 03:31:20 +0100524Return a Unicode string of one character with ordinal i; 0 <= i <= 0x10ffff.");
Guido van Rossum09095f32000-03-10 23:00:52 +0000525
526
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000527static char *
Benjamin Petersonf5b52242009-03-02 23:31:26 +0000528source_as_string(PyObject *cmd, char *funcname, char *what, PyCompilerFlags *cf)
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000529{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000530 char *str;
531 Py_ssize_t size;
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000532
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000533 if (PyUnicode_Check(cmd)) {
534 cf->cf_flags |= PyCF_IGNORE_COOKIE;
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200535 str = PyUnicode_AsUTF8AndSize(cmd, &size);
536 if (str == NULL)
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000537 return NULL;
538 }
539 else if (!PyObject_CheckReadBuffer(cmd)) {
540 PyErr_Format(PyExc_TypeError,
541 "%s() arg 1 must be a %s object",
542 funcname, what);
543 return NULL;
544 }
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200545 else if (PyObject_AsReadBuffer(cmd, (const void **)&str, &size) < 0) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000546 return NULL;
547 }
Martin v. Löwisd63a3b82011-09-28 07:41:54 +0200548
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000549 if (strlen(str) != size) {
550 PyErr_SetString(PyExc_TypeError,
551 "source code string cannot contain null bytes");
552 return NULL;
553 }
554 return str;
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000555}
556
Guido van Rossum79f25d91997-04-29 20:08:16 +0000557static PyObject *
Guido van Rossumd8faa362007-04-27 19:54:29 +0000558builtin_compile(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum5b722181993-03-30 17:46:03 +0000559{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000560 char *str;
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000561 PyObject *filename_obj;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000562 char *filename;
563 char *startstr;
564 int mode = -1;
565 int dont_inherit = 0;
566 int supplied_flags = 0;
Georg Brandl8334fd92010-12-04 10:26:46 +0000567 int optimize = -1;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000568 int is_ast;
569 PyCompilerFlags cf;
570 PyObject *cmd;
571 static char *kwlist[] = {"source", "filename", "mode", "flags",
Georg Brandl8334fd92010-12-04 10:26:46 +0000572 "dont_inherit", "optimize", NULL};
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000573 int start[] = {Py_file_input, Py_eval_input, Py_single_input};
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000574 PyObject *result;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000575
Georg Brandl8334fd92010-12-04 10:26:46 +0000576 if (!PyArg_ParseTupleAndKeywords(args, kwds, "OO&s|iii:compile", kwlist,
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000577 &cmd,
578 PyUnicode_FSConverter, &filename_obj,
579 &startstr, &supplied_flags,
Georg Brandl8334fd92010-12-04 10:26:46 +0000580 &dont_inherit, &optimize))
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000581 return NULL;
Tim Peters6cd6a822001-08-17 22:11:27 +0000582
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000583 filename = PyBytes_AS_STRING(filename_obj);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000584 cf.cf_flags = supplied_flags | PyCF_SOURCE_IS_UTF8;
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000585
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000586 if (supplied_flags &
587 ~(PyCF_MASK | PyCF_MASK_OBSOLETE | PyCF_DONT_IMPLY_DEDENT | PyCF_ONLY_AST))
588 {
589 PyErr_SetString(PyExc_ValueError,
590 "compile(): unrecognised flags");
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000591 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000592 }
593 /* XXX Warn if (supplied_flags & PyCF_MASK_OBSOLETE) != 0? */
Tim Peters6cd6a822001-08-17 22:11:27 +0000594
Georg Brandl8334fd92010-12-04 10:26:46 +0000595 if (optimize < -1 || optimize > 2) {
596 PyErr_SetString(PyExc_ValueError,
597 "compile(): invalid optimize value");
598 goto error;
599 }
600
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000601 if (!dont_inherit) {
602 PyEval_MergeCompilerFlags(&cf);
603 }
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000604
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000605 if (strcmp(startstr, "exec") == 0)
606 mode = 0;
607 else if (strcmp(startstr, "eval") == 0)
608 mode = 1;
609 else if (strcmp(startstr, "single") == 0)
610 mode = 2;
611 else {
612 PyErr_SetString(PyExc_ValueError,
613 "compile() arg 3 must be 'exec', 'eval' or 'single'");
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000614 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000615 }
Neal Norwitzdb4115f2008-03-31 04:20:05 +0000616
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000617 is_ast = PyAST_Check(cmd);
618 if (is_ast == -1)
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000619 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000620 if (is_ast) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000621 if (supplied_flags & PyCF_ONLY_AST) {
622 Py_INCREF(cmd);
623 result = cmd;
624 }
625 else {
626 PyArena *arena;
627 mod_ty mod;
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000628
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000629 arena = PyArena_New();
630 mod = PyAST_obj2mod(cmd, arena, mode);
631 if (mod == NULL) {
632 PyArena_Free(arena);
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000633 goto error;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000634 }
Benjamin Peterson832bfe22011-08-09 16:15:04 -0500635 if (!PyAST_Validate(mod)) {
636 PyArena_Free(arena);
637 goto error;
638 }
Georg Brandl8334fd92010-12-04 10:26:46 +0000639 result = (PyObject*)PyAST_CompileEx(mod, filename,
640 &cf, optimize, arena);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000641 PyArena_Free(arena);
642 }
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000643 goto finally;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000644 }
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000645
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000646 str = source_as_string(cmd, "compile", "string, bytes, AST or code", &cf);
647 if (str == NULL)
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000648 goto error;
Martin v. Löwis618dc5e2008-03-30 20:03:44 +0000649
Georg Brandl8334fd92010-12-04 10:26:46 +0000650 result = Py_CompileStringExFlags(str, filename, start[mode], &cf, optimize);
Victor Stinner4c7c8c32010-10-16 13:14:10 +0000651 goto finally;
652
653error:
654 result = NULL;
655finally:
656 Py_DECREF(filename_obj);
657 return result;
Guido van Rossum5b722181993-03-30 17:46:03 +0000658}
659
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000660PyDoc_STRVAR(compile_doc,
Tim Peters6cd6a822001-08-17 22:11:27 +0000661"compile(source, filename, mode[, flags[, dont_inherit]]) -> code object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000662\n\
663Compile the source string (a Python module, statement or expression)\n\
Georg Brandl7cae87c2006-09-06 06:51:57 +0000664into a code object that can be executed by exec() or eval().\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000665The filename will be used for run-time error messages.\n\
666The mode must be 'exec' to compile a module, 'single' to compile a\n\
Tim Peters6cd6a822001-08-17 22:11:27 +0000667single (interactive) statement, or 'eval' to compile an expression.\n\
668The flags argument, if present, controls which future statements influence\n\
669the compilation of the code.\n\
670The dont_inherit argument, if non-zero, stops the compilation inheriting\n\
671the effects of any future statements in effect in the code calling\n\
672compile; if absent or zero these statements do influence the compilation,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000673in addition to any features explicitly specified.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000674
Guido van Rossum79f25d91997-04-29 20:08:16 +0000675static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000676builtin_dir(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000677{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000678 PyObject *arg = NULL;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000679
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000680 if (!PyArg_UnpackTuple(args, "dir", 0, 1, &arg))
681 return NULL;
682 return PyObject_Dir(arg);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000683}
684
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000685PyDoc_STRVAR(dir_doc,
Tim Peters5d2b77c2001-09-03 05:47:38 +0000686"dir([object]) -> list of strings\n"
687"\n"
Georg Brandle32b4222007-03-10 22:13:27 +0000688"If called without an argument, return the names in the current scope.\n"
689"Else, return an alphabetized list of names comprising (some of) the attributes\n"
690"of the given object, and of attributes reachable from it.\n"
691"If the object supplies a method named __dir__, it will be used; otherwise\n"
692"the default dir() logic is used and returns:\n"
693" for a module object: the module's attributes.\n"
694" for a class object: its attributes, and recursively the attributes\n"
695" of its bases.\n"
Guido van Rossumd8faa362007-04-27 19:54:29 +0000696" for any other object: its attributes, its class's attributes, and\n"
Georg Brandle32b4222007-03-10 22:13:27 +0000697" recursively the attributes of its class's base classes.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000698
Guido van Rossum79f25d91997-04-29 20:08:16 +0000699static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000700builtin_divmod(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000701{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000702 PyObject *v, *w;
Guido van Rossum6a00cd81995-01-07 12:39:01 +0000703
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000704 if (!PyArg_UnpackTuple(args, "divmod", 2, 2, &v, &w))
705 return NULL;
706 return PyNumber_Divmod(v, w);
Guido van Rossum3f5da241990-12-20 15:06:42 +0000707}
708
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000709PyDoc_STRVAR(divmod_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000710"divmod(x, y) -> (div, mod)\n\
711\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000712Return the tuple ((x-x%y)/y, x%y). Invariant: div*y + mod == x.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000713
714
Guido van Rossum79f25d91997-04-29 20:08:16 +0000715static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000716builtin_eval(PyObject *self, PyObject *args)
Guido van Rossum3f5da241990-12-20 15:06:42 +0000717{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000718 PyObject *cmd, *result, *tmp = NULL;
719 PyObject *globals = Py_None, *locals = Py_None;
720 char *str;
721 PyCompilerFlags cf;
Guido van Rossum590baa41993-11-30 13:40:46 +0000722
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000723 if (!PyArg_UnpackTuple(args, "eval", 1, 3, &cmd, &globals, &locals))
724 return NULL;
725 if (locals != Py_None && !PyMapping_Check(locals)) {
726 PyErr_SetString(PyExc_TypeError, "locals must be a mapping");
727 return NULL;
728 }
729 if (globals != Py_None && !PyDict_Check(globals)) {
730 PyErr_SetString(PyExc_TypeError, PyMapping_Check(globals) ?
731 "globals must be a real dict; try eval(expr, {}, mapping)"
732 : "globals must be a dict");
733 return NULL;
734 }
735 if (globals == Py_None) {
736 globals = PyEval_GetGlobals();
737 if (locals == Py_None)
738 locals = PyEval_GetLocals();
739 }
740 else if (locals == Py_None)
741 locals = globals;
Tim Peters9fa96be2001-08-17 23:04:59 +0000742
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000743 if (globals == NULL || locals == NULL) {
744 PyErr_SetString(PyExc_TypeError,
745 "eval must be given globals and locals "
746 "when called without a frame");
747 return NULL;
748 }
Georg Brandl77c85e62005-09-15 10:46:13 +0000749
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000750 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
751 if (PyDict_SetItemString(globals, "__builtins__",
752 PyEval_GetBuiltins()) != 0)
753 return NULL;
754 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000755
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000756 if (PyCode_Check(cmd)) {
757 if (PyCode_GetNumFree((PyCodeObject *)cmd) > 0) {
758 PyErr_SetString(PyExc_TypeError,
759 "code object passed to eval() may not contain free variables");
760 return NULL;
761 }
Martin v. Löwis4d0d4712010-12-03 20:14:31 +0000762 return PyEval_EvalCode(cmd, globals, locals);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000763 }
Tim Peters9fa96be2001-08-17 23:04:59 +0000764
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000765 cf.cf_flags = PyCF_SOURCE_IS_UTF8;
766 str = source_as_string(cmd, "eval", "string, bytes or code", &cf);
767 if (str == NULL)
768 return NULL;
Just van Rossum3aaf42c2003-02-10 08:21:10 +0000769
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000770 while (*str == ' ' || *str == '\t')
771 str++;
Tim Peters9fa96be2001-08-17 23:04:59 +0000772
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000773 (void)PyEval_MergeCompilerFlags(&cf);
774 result = PyRun_StringFlags(str, Py_eval_input, globals, locals, &cf);
775 Py_XDECREF(tmp);
776 return result;
Guido van Rossum3f5da241990-12-20 15:06:42 +0000777}
778
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000779PyDoc_STRVAR(eval_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000780"eval(source[, globals[, locals]]) -> value\n\
781\n\
782Evaluate the source in the context of globals and locals.\n\
783The source may be a string representing a Python expression\n\
784or a code object as returned by compile().\n\
Thomas Wouters89f507f2006-12-13 04:49:30 +0000785The globals must be a dictionary and locals can be any mapping,\n\
Raymond Hettinger214b1c32004-07-02 06:41:07 +0000786defaulting to the current globals and locals.\n\
787If only globals is given, locals defaults to it.\n");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000788
Georg Brandl7cae87c2006-09-06 06:51:57 +0000789static PyObject *
790builtin_exec(PyObject *self, PyObject *args)
791{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000792 PyObject *v;
793 PyObject *prog, *globals = Py_None, *locals = Py_None;
Georg Brandl7cae87c2006-09-06 06:51:57 +0000794
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000795 if (!PyArg_UnpackTuple(args, "exec", 1, 3, &prog, &globals, &locals))
796 return NULL;
Georg Brandl2cabc562008-08-28 07:57:16 +0000797
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000798 if (globals == Py_None) {
799 globals = PyEval_GetGlobals();
800 if (locals == Py_None) {
801 locals = PyEval_GetLocals();
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000802 }
803 if (!globals || !locals) {
804 PyErr_SetString(PyExc_SystemError,
805 "globals and locals cannot be NULL");
806 return NULL;
807 }
808 }
809 else if (locals == Py_None)
810 locals = globals;
Georg Brandl7cae87c2006-09-06 06:51:57 +0000811
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000812 if (!PyDict_Check(globals)) {
813 PyErr_Format(PyExc_TypeError, "exec() arg 2 must be a dict, not %.100s",
814 globals->ob_type->tp_name);
815 return NULL;
816 }
817 if (!PyMapping_Check(locals)) {
818 PyErr_Format(PyExc_TypeError,
819 "arg 3 must be a mapping or None, not %.100s",
820 locals->ob_type->tp_name);
821 return NULL;
822 }
823 if (PyDict_GetItemString(globals, "__builtins__") == NULL) {
824 if (PyDict_SetItemString(globals, "__builtins__",
825 PyEval_GetBuiltins()) != 0)
826 return NULL;
827 }
828
829 if (PyCode_Check(prog)) {
830 if (PyCode_GetNumFree((PyCodeObject *)prog) > 0) {
831 PyErr_SetString(PyExc_TypeError,
832 "code object passed to exec() may not "
833 "contain free variables");
834 return NULL;
835 }
Martin v. Löwis4d0d4712010-12-03 20:14:31 +0000836 v = PyEval_EvalCode(prog, globals, locals);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000837 }
838 else {
839 char *str;
840 PyCompilerFlags cf;
841 cf.cf_flags = PyCF_SOURCE_IS_UTF8;
842 str = source_as_string(prog, "exec",
843 "string, bytes or code", &cf);
844 if (str == NULL)
845 return NULL;
846 if (PyEval_MergeCompilerFlags(&cf))
847 v = PyRun_StringFlags(str, Py_file_input, globals,
848 locals, &cf);
849 else
850 v = PyRun_String(str, Py_file_input, globals, locals);
851 }
852 if (v == NULL)
853 return NULL;
854 Py_DECREF(v);
855 Py_RETURN_NONE;
Georg Brandl7cae87c2006-09-06 06:51:57 +0000856}
857
858PyDoc_STRVAR(exec_doc,
859"exec(object[, globals[, locals]])\n\
860\n\
Mark Dickinson480e8e32009-12-19 21:19:35 +0000861Read and execute code from an object, which can be a string or a code\n\
Benjamin Peterson38090262009-01-04 15:30:39 +0000862object.\n\
Georg Brandl7cae87c2006-09-06 06:51:57 +0000863The globals and locals are dictionaries, defaulting to the current\n\
864globals and locals. If only globals is given, locals defaults to it.");
865
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000866
Guido van Rossum79f25d91997-04-29 20:08:16 +0000867static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000868builtin_getattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +0000869{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000870 PyObject *v, *result, *dflt = NULL;
871 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000872
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000873 if (!PyArg_UnpackTuple(args, "getattr", 2, 3, &v, &name, &dflt))
874 return NULL;
Martin v. Löwis5b222132007-06-10 09:51:05 +0000875
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000876 if (!PyUnicode_Check(name)) {
877 PyErr_SetString(PyExc_TypeError,
878 "getattr(): attribute name must be string");
879 return NULL;
880 }
881 result = PyObject_GetAttr(v, name);
882 if (result == NULL && dflt != NULL &&
883 PyErr_ExceptionMatches(PyExc_AttributeError))
884 {
885 PyErr_Clear();
886 Py_INCREF(dflt);
887 result = dflt;
888 }
889 return result;
Guido van Rossum9bfef441993-03-29 10:43:31 +0000890}
891
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000892PyDoc_STRVAR(getattr_doc,
Guido van Rossum950ff291998-06-29 13:38:57 +0000893"getattr(object, name[, default]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000894\n\
Guido van Rossum950ff291998-06-29 13:38:57 +0000895Get a named attribute from an object; getattr(x, 'y') is equivalent to x.y.\n\
896When a default argument is given, it is returned when the attribute doesn't\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000897exist; without it, an exception is raised in that case.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000898
899
Guido van Rossum79f25d91997-04-29 20:08:16 +0000900static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000901builtin_globals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +0000902{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000903 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000904
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000905 d = PyEval_GetGlobals();
906 Py_XINCREF(d);
907 return d;
Guido van Rossum872537c1995-07-07 22:43:42 +0000908}
909
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000910PyDoc_STRVAR(globals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000911"globals() -> dictionary\n\
912\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000913Return the dictionary containing the current scope's global variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000914
915
Guido van Rossum79f25d91997-04-29 20:08:16 +0000916static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +0000917builtin_hasattr(PyObject *self, PyObject *args)
Guido van Rossum9bfef441993-03-29 10:43:31 +0000918{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000919 PyObject *v;
920 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000921
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000922 if (!PyArg_UnpackTuple(args, "hasattr", 2, 2, &v, &name))
923 return NULL;
924 if (!PyUnicode_Check(name)) {
925 PyErr_SetString(PyExc_TypeError,
926 "hasattr(): attribute name must be string");
927 return NULL;
928 }
929 v = PyObject_GetAttr(v, name);
930 if (v == NULL) {
Benjamin Peterson17689992010-08-24 03:26:23 +0000931 if (PyErr_ExceptionMatches(PyExc_AttributeError)) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000932 PyErr_Clear();
Benjamin Peterson17689992010-08-24 03:26:23 +0000933 Py_RETURN_FALSE;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000934 }
Benjamin Peterson17689992010-08-24 03:26:23 +0000935 return NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000936 }
937 Py_DECREF(v);
Benjamin Peterson17689992010-08-24 03:26:23 +0000938 Py_RETURN_TRUE;
Guido van Rossum33894be1992-01-27 16:53:09 +0000939}
940
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000941PyDoc_STRVAR(hasattr_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +0000942"hasattr(object, name) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000943\n\
944Return whether the object has an attribute with the given name.\n\
Benjamin Peterson17689992010-08-24 03:26:23 +0000945(This is done by calling getattr(object, name) and catching AttributeError.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000946
947
Guido van Rossum79f25d91997-04-29 20:08:16 +0000948static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +0000949builtin_id(PyObject *self, PyObject *v)
Guido van Rossum5b722181993-03-30 17:46:03 +0000950{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000951 return PyLong_FromVoidPtr(v);
Guido van Rossum5b722181993-03-30 17:46:03 +0000952}
953
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000954PyDoc_STRVAR(id_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000955"id(object) -> integer\n\
956\n\
957Return the identity of an object. This is guaranteed to be unique among\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000958simultaneously existing objects. (Hint: it's the object's memory address.)");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +0000959
960
Raymond Hettingera6c60372008-03-13 01:26:19 +0000961/* map object ************************************************************/
962
963typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000964 PyObject_HEAD
965 PyObject *iters;
966 PyObject *func;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000967} mapobject;
968
Guido van Rossum79f25d91997-04-29 20:08:16 +0000969static PyObject *
Raymond Hettingera6c60372008-03-13 01:26:19 +0000970map_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
Guido van Rossum12d12c51993-10-26 17:58:25 +0000971{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000972 PyObject *it, *iters, *func;
973 mapobject *lz;
974 Py_ssize_t numargs, i;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000975
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000976 if (type == &PyMap_Type && !_PyArg_NoKeywords("map()", kwds))
977 return NULL;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000978
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000979 numargs = PyTuple_Size(args);
980 if (numargs < 2) {
981 PyErr_SetString(PyExc_TypeError,
982 "map() must have at least two arguments.");
983 return NULL;
984 }
Raymond Hettingera6c60372008-03-13 01:26:19 +0000985
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000986 iters = PyTuple_New(numargs-1);
987 if (iters == NULL)
988 return NULL;
Raymond Hettingera6c60372008-03-13 01:26:19 +0000989
Antoine Pitrouf95a1b32010-05-09 15:52:27 +0000990 for (i=1 ; i<numargs ; i++) {
991 /* Get iterator. */
992 it = PyObject_GetIter(PyTuple_GET_ITEM(args, i));
993 if (it == NULL) {
994 Py_DECREF(iters);
995 return NULL;
996 }
997 PyTuple_SET_ITEM(iters, i-1, it);
998 }
Raymond Hettingera6c60372008-03-13 01:26:19 +0000999
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001000 /* create mapobject structure */
1001 lz = (mapobject *)type->tp_alloc(type, 0);
1002 if (lz == NULL) {
1003 Py_DECREF(iters);
1004 return NULL;
1005 }
1006 lz->iters = iters;
1007 func = PyTuple_GET_ITEM(args, 0);
1008 Py_INCREF(func);
1009 lz->func = func;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001010
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001011 return (PyObject *)lz;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001012}
1013
1014static void
1015map_dealloc(mapobject *lz)
1016{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001017 PyObject_GC_UnTrack(lz);
1018 Py_XDECREF(lz->iters);
1019 Py_XDECREF(lz->func);
1020 Py_TYPE(lz)->tp_free(lz);
Raymond Hettingera6c60372008-03-13 01:26:19 +00001021}
1022
1023static int
1024map_traverse(mapobject *lz, visitproc visit, void *arg)
1025{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001026 Py_VISIT(lz->iters);
1027 Py_VISIT(lz->func);
1028 return 0;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001029}
1030
1031static PyObject *
1032map_next(mapobject *lz)
1033{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001034 PyObject *val;
1035 PyObject *argtuple;
1036 PyObject *result;
1037 Py_ssize_t numargs, i;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001038
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001039 numargs = PyTuple_Size(lz->iters);
1040 argtuple = PyTuple_New(numargs);
1041 if (argtuple == NULL)
1042 return NULL;
Raymond Hettingera6c60372008-03-13 01:26:19 +00001043
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001044 for (i=0 ; i<numargs ; i++) {
1045 val = PyIter_Next(PyTuple_GET_ITEM(lz->iters, i));
1046 if (val == NULL) {
1047 Py_DECREF(argtuple);
1048 return NULL;
1049 }
1050 PyTuple_SET_ITEM(argtuple, i, val);
1051 }
1052 result = PyObject_Call(lz->func, argtuple, NULL);
1053 Py_DECREF(argtuple);
1054 return result;
Guido van Rossum12d12c51993-10-26 17:58:25 +00001055}
1056
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001057PyDoc_STRVAR(map_doc,
Raymond Hettingera6c60372008-03-13 01:26:19 +00001058"map(func, *iterables) --> map object\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001059\n\
Raymond Hettingera6c60372008-03-13 01:26:19 +00001060Make an iterator that computes the function using arguments from\n\
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001061each of the iterables. Stops when the shortest iterable is exhausted.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001062
Raymond Hettingera6c60372008-03-13 01:26:19 +00001063PyTypeObject PyMap_Type = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001064 PyVarObject_HEAD_INIT(&PyType_Type, 0)
1065 "map", /* tp_name */
1066 sizeof(mapobject), /* tp_basicsize */
1067 0, /* tp_itemsize */
1068 /* methods */
1069 (destructor)map_dealloc, /* tp_dealloc */
1070 0, /* tp_print */
1071 0, /* tp_getattr */
1072 0, /* tp_setattr */
1073 0, /* tp_reserved */
1074 0, /* tp_repr */
1075 0, /* tp_as_number */
1076 0, /* tp_as_sequence */
1077 0, /* tp_as_mapping */
1078 0, /* tp_hash */
1079 0, /* tp_call */
1080 0, /* tp_str */
1081 PyObject_GenericGetAttr, /* tp_getattro */
1082 0, /* tp_setattro */
1083 0, /* tp_as_buffer */
1084 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
1085 Py_TPFLAGS_BASETYPE, /* tp_flags */
1086 map_doc, /* tp_doc */
1087 (traverseproc)map_traverse, /* tp_traverse */
1088 0, /* tp_clear */
1089 0, /* tp_richcompare */
1090 0, /* tp_weaklistoffset */
1091 PyObject_SelfIter, /* tp_iter */
1092 (iternextfunc)map_next, /* tp_iternext */
1093 0, /* tp_methods */
1094 0, /* tp_members */
1095 0, /* tp_getset */
1096 0, /* tp_base */
1097 0, /* tp_dict */
1098 0, /* tp_descr_get */
1099 0, /* tp_descr_set */
1100 0, /* tp_dictoffset */
1101 0, /* tp_init */
1102 PyType_GenericAlloc, /* tp_alloc */
1103 map_new, /* tp_new */
1104 PyObject_GC_Del, /* tp_free */
Raymond Hettingera6c60372008-03-13 01:26:19 +00001105};
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001106
Guido van Rossum79f25d91997-04-29 20:08:16 +00001107static PyObject *
Georg Brandla18af4e2007-04-21 15:47:16 +00001108builtin_next(PyObject *self, PyObject *args)
1109{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001110 PyObject *it, *res;
1111 PyObject *def = NULL;
Georg Brandla18af4e2007-04-21 15:47:16 +00001112
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001113 if (!PyArg_UnpackTuple(args, "next", 1, 2, &it, &def))
1114 return NULL;
1115 if (!PyIter_Check(it)) {
1116 PyErr_Format(PyExc_TypeError,
Philip Jenvey50add042011-11-06 16:37:52 -08001117 "'%.200s' object is not an iterator",
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001118 it->ob_type->tp_name);
1119 return NULL;
1120 }
1121
1122 res = (*it->ob_type->tp_iternext)(it);
1123 if (res != NULL) {
1124 return res;
1125 } else if (def != NULL) {
1126 if (PyErr_Occurred()) {
1127 if(!PyErr_ExceptionMatches(PyExc_StopIteration))
1128 return NULL;
1129 PyErr_Clear();
1130 }
1131 Py_INCREF(def);
1132 return def;
1133 } else if (PyErr_Occurred()) {
1134 return NULL;
1135 } else {
1136 PyErr_SetNone(PyExc_StopIteration);
1137 return NULL;
1138 }
Georg Brandla18af4e2007-04-21 15:47:16 +00001139}
1140
1141PyDoc_STRVAR(next_doc,
1142"next(iterator[, default])\n\
1143\n\
1144Return the next item from the iterator. If default is given and the iterator\n\
1145is exhausted, it is returned instead of raising StopIteration.");
1146
1147
1148static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001149builtin_setattr(PyObject *self, PyObject *args)
Guido van Rossum33894be1992-01-27 16:53:09 +00001150{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001151 PyObject *v;
1152 PyObject *name;
1153 PyObject *value;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001154
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001155 if (!PyArg_UnpackTuple(args, "setattr", 3, 3, &v, &name, &value))
1156 return NULL;
1157 if (PyObject_SetAttr(v, name, value) != 0)
1158 return NULL;
1159 Py_INCREF(Py_None);
1160 return Py_None;
Guido van Rossum33894be1992-01-27 16:53:09 +00001161}
1162
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001163PyDoc_STRVAR(setattr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001164"setattr(object, name, value)\n\
1165\n\
1166Set a named attribute on an object; setattr(x, 'y', v) is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001167``x.y = v''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001168
1169
Guido van Rossum79f25d91997-04-29 20:08:16 +00001170static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001171builtin_delattr(PyObject *self, PyObject *args)
Guido van Rossum14144fc1994-08-29 12:53:40 +00001172{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001173 PyObject *v;
1174 PyObject *name;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001175
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001176 if (!PyArg_UnpackTuple(args, "delattr", 2, 2, &v, &name))
1177 return NULL;
1178 if (PyObject_SetAttr(v, name, (PyObject *)NULL) != 0)
1179 return NULL;
1180 Py_INCREF(Py_None);
1181 return Py_None;
Guido van Rossum14144fc1994-08-29 12:53:40 +00001182}
1183
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001184PyDoc_STRVAR(delattr_doc,
Guido van Rossumdf12a591998-11-23 22:13:04 +00001185"delattr(object, name)\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001186\n\
1187Delete a named attribute on an object; delattr(x, 'y') is equivalent to\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001188``del x.y''.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001189
1190
Guido van Rossum79f25d91997-04-29 20:08:16 +00001191static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001192builtin_hash(PyObject *self, PyObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00001193{
Benjamin Peterson8f67d082010-10-17 20:54:53 +00001194 Py_hash_t x;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001195
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001196 x = PyObject_Hash(v);
1197 if (x == -1)
1198 return NULL;
Benjamin Peterson8f67d082010-10-17 20:54:53 +00001199 return PyLong_FromSsize_t(x);
Guido van Rossum9bfef441993-03-29 10:43:31 +00001200}
1201
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001202PyDoc_STRVAR(hash_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001203"hash(object) -> integer\n\
1204\n\
1205Return a hash value for the object. Two objects with the same value have\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001206the same hash value. The reverse is not necessarily true, but likely.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001207
1208
Guido van Rossum79f25d91997-04-29 20:08:16 +00001209static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001210builtin_hex(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001211{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001212 return PyNumber_ToBase(v, 16);
Guido van Rossum006bcd41991-10-24 14:54:44 +00001213}
1214
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001215PyDoc_STRVAR(hex_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001216"hex(number) -> string\n\
1217\n\
Alexander Belopolsky12338ab2011-04-07 00:15:33 -04001218Return the hexadecimal representation of an integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001219
1220
Guido van Rossum79f25d91997-04-29 20:08:16 +00001221static PyObject *
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001222builtin_iter(PyObject *self, PyObject *args)
1223{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001224 PyObject *v, *w = NULL;
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001225
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001226 if (!PyArg_UnpackTuple(args, "iter", 1, 2, &v, &w))
1227 return NULL;
1228 if (w == NULL)
1229 return PyObject_GetIter(v);
1230 if (!PyCallable_Check(v)) {
1231 PyErr_SetString(PyExc_TypeError,
1232 "iter(v, w): v must be callable");
1233 return NULL;
1234 }
1235 return PyCallIter_New(v, w);
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001236}
1237
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001238PyDoc_STRVAR(iter_doc,
Georg Brandld11ae5d2008-05-16 13:27:32 +00001239"iter(iterable) -> iterator\n\
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001240iter(callable, sentinel) -> iterator\n\
1241\n\
1242Get an iterator from an object. In the first form, the argument must\n\
1243supply its own iterator, or be a sequence.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001244In the second form, the callable is called until it returns the sentinel.");
Guido van Rossum59d1d2b2001-04-20 19:13:02 +00001245
1246
1247static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001248builtin_len(PyObject *self, PyObject *v)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001249{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001250 Py_ssize_t res;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001251
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001252 res = PyObject_Size(v);
1253 if (res < 0 && PyErr_Occurred())
1254 return NULL;
1255 return PyLong_FromSsize_t(res);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001256}
1257
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001258PyDoc_STRVAR(len_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001259"len(object) -> integer\n\
1260\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001261Return the number of items of a sequence or mapping.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001262
1263
Guido van Rossum79f25d91997-04-29 20:08:16 +00001264static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001265builtin_locals(PyObject *self)
Guido van Rossum872537c1995-07-07 22:43:42 +00001266{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001267 PyObject *d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001268
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001269 d = PyEval_GetLocals();
1270 Py_XINCREF(d);
1271 return d;
Guido van Rossum872537c1995-07-07 22:43:42 +00001272}
1273
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001274PyDoc_STRVAR(locals_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001275"locals() -> dictionary\n\
1276\n\
Raymond Hettinger69bf8f32003-01-04 02:16:22 +00001277Update and return a dictionary containing the current scope's local variables.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001278
1279
Guido van Rossum79f25d91997-04-29 20:08:16 +00001280static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001281min_max(PyObject *args, PyObject *kwds, int op)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001282{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001283 PyObject *v, *it, *item, *val, *maxitem, *maxval, *keyfunc=NULL;
1284 const char *name = op == Py_LT ? "min" : "max";
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001285
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001286 if (PyTuple_Size(args) > 1)
1287 v = args;
1288 else if (!PyArg_UnpackTuple(args, (char *)name, 1, 1, &v))
1289 return NULL;
Tim Peters67d687a2002-04-29 21:27:32 +00001290
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001291 if (kwds != NULL && PyDict_Check(kwds) && PyDict_Size(kwds)) {
1292 keyfunc = PyDict_GetItemString(kwds, "key");
1293 if (PyDict_Size(kwds)!=1 || keyfunc == NULL) {
1294 PyErr_Format(PyExc_TypeError,
1295 "%s() got an unexpected keyword argument", name);
1296 return NULL;
1297 }
1298 Py_INCREF(keyfunc);
1299 }
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001300
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001301 it = PyObject_GetIter(v);
1302 if (it == NULL) {
1303 Py_XDECREF(keyfunc);
1304 return NULL;
1305 }
Tim Petersc3074532001-05-03 07:00:32 +00001306
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001307 maxitem = NULL; /* the result */
1308 maxval = NULL; /* the value associated with the result */
1309 while (( item = PyIter_Next(it) )) {
1310 /* get the value from the key function */
1311 if (keyfunc != NULL) {
1312 val = PyObject_CallFunctionObjArgs(keyfunc, item, NULL);
1313 if (val == NULL)
1314 goto Fail_it_item;
1315 }
1316 /* no key function; the value is the item */
1317 else {
1318 val = item;
1319 Py_INCREF(val);
1320 }
Tim Petersc3074532001-05-03 07:00:32 +00001321
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001322 /* maximum value and item are unset; set them */
1323 if (maxval == NULL) {
1324 maxitem = item;
1325 maxval = val;
1326 }
1327 /* maximum value and item are set; update them as necessary */
1328 else {
1329 int cmp = PyObject_RichCompareBool(val, maxval, op);
1330 if (cmp < 0)
1331 goto Fail_it_item_and_val;
1332 else if (cmp > 0) {
1333 Py_DECREF(maxval);
1334 Py_DECREF(maxitem);
1335 maxval = val;
1336 maxitem = item;
1337 }
1338 else {
1339 Py_DECREF(item);
1340 Py_DECREF(val);
1341 }
1342 }
1343 }
1344 if (PyErr_Occurred())
1345 goto Fail_it;
1346 if (maxval == NULL) {
1347 PyErr_Format(PyExc_ValueError,
1348 "%s() arg is an empty sequence", name);
1349 assert(maxitem == NULL);
1350 }
1351 else
1352 Py_DECREF(maxval);
1353 Py_DECREF(it);
1354 Py_XDECREF(keyfunc);
1355 return maxitem;
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001356
1357Fail_it_item_and_val:
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001358 Py_DECREF(val);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001359Fail_it_item:
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001360 Py_DECREF(item);
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001361Fail_it:
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001362 Py_XDECREF(maxval);
1363 Py_XDECREF(maxitem);
1364 Py_DECREF(it);
1365 Py_XDECREF(keyfunc);
1366 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001367}
1368
Guido van Rossum79f25d91997-04-29 20:08:16 +00001369static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001370builtin_min(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001371{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001372 return min_max(args, kwds, Py_LT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001373}
1374
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001375PyDoc_STRVAR(min_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001376"min(iterable[, key=func]) -> value\n\
1377min(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001378\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001379With a single iterable argument, return its smallest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001380With two or more arguments, return the smallest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001381
1382
Guido van Rossum79f25d91997-04-29 20:08:16 +00001383static PyObject *
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001384builtin_max(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001385{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001386 return min_max(args, kwds, Py_GT);
Guido van Rossum3f5da241990-12-20 15:06:42 +00001387}
1388
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001389PyDoc_STRVAR(max_doc,
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001390"max(iterable[, key=func]) -> value\n\
1391max(a, b, c, ...[, key=func]) -> value\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001392\n\
Raymond Hettinger3b0c7c22004-12-03 08:30:39 +00001393With a single iterable argument, return its largest item.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001394With two or more arguments, return the largest argument.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001395
1396
Guido van Rossum79f25d91997-04-29 20:08:16 +00001397static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001398builtin_oct(PyObject *self, PyObject *v)
Guido van Rossum006bcd41991-10-24 14:54:44 +00001399{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001400 return PyNumber_ToBase(v, 8);
Guido van Rossum006bcd41991-10-24 14:54:44 +00001401}
1402
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001403PyDoc_STRVAR(oct_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001404"oct(number) -> string\n\
1405\n\
Alexander Belopolsky12338ab2011-04-07 00:15:33 -04001406Return the octal representation of an integer.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001407
1408
Guido van Rossum79f25d91997-04-29 20:08:16 +00001409static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001410builtin_ord(PyObject *self, PyObject* obj)
Guido van Rossum3f5da241990-12-20 15:06:42 +00001411{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001412 long ord;
1413 Py_ssize_t size;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001414
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001415 if (PyBytes_Check(obj)) {
1416 size = PyBytes_GET_SIZE(obj);
1417 if (size == 1) {
1418 ord = (long)((unsigned char)*PyBytes_AS_STRING(obj));
1419 return PyLong_FromLong(ord);
1420 }
1421 }
1422 else if (PyUnicode_Check(obj)) {
Martin v. Löwisd63a3b82011-09-28 07:41:54 +02001423 if (PyUnicode_READY(obj) == -1)
1424 return NULL;
1425 size = PyUnicode_GET_LENGTH(obj);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001426 if (size == 1) {
Martin v. Löwisd63a3b82011-09-28 07:41:54 +02001427 ord = (long)PyUnicode_READ_CHAR(obj, 0);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001428 return PyLong_FromLong(ord);
1429 }
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001430 }
1431 else if (PyByteArray_Check(obj)) {
1432 /* XXX Hopefully this is temporary */
1433 size = PyByteArray_GET_SIZE(obj);
1434 if (size == 1) {
1435 ord = (long)((unsigned char)*PyByteArray_AS_STRING(obj));
1436 return PyLong_FromLong(ord);
1437 }
1438 }
1439 else {
1440 PyErr_Format(PyExc_TypeError,
1441 "ord() expected string of length 1, but " \
1442 "%.200s found", obj->ob_type->tp_name);
1443 return NULL;
1444 }
Guido van Rossum09095f32000-03-10 23:00:52 +00001445
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001446 PyErr_Format(PyExc_TypeError,
1447 "ord() expected a character, "
1448 "but string of length %zd found",
1449 size);
1450 return NULL;
Guido van Rossum3f5da241990-12-20 15:06:42 +00001451}
1452
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001453PyDoc_VAR(ord_doc) = PyDoc_STR(
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001454"ord(c) -> integer\n\
1455\n\
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001456Return the integer ordinal of a one-character string."
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001457)
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001458#ifndef Py_UNICODE_WIDE
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001459PyDoc_STR(
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001460"\nA valid surrogate pair is also accepted."
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001461)
Guido van Rossum8ac004e2007-07-15 13:00:05 +00001462#endif
Guido van Rossum307fa8c2007-07-16 20:46:27 +00001463;
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001464
1465
Guido van Rossum79f25d91997-04-29 20:08:16 +00001466static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001467builtin_pow(PyObject *self, PyObject *args)
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001468{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001469 PyObject *v, *w, *z = Py_None;
Guido van Rossum6a00cd81995-01-07 12:39:01 +00001470
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001471 if (!PyArg_UnpackTuple(args, "pow", 2, 3, &v, &w, &z))
1472 return NULL;
1473 return PyNumber_Power(v, w, z);
Guido van Rossumd4905451991-05-05 20:00:36 +00001474}
1475
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001476PyDoc_STRVAR(pow_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001477"pow(x, y[, z]) -> number\n\
1478\n\
1479With two arguments, equivalent to x**y. With three arguments,\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001480equivalent to (x**y) % z, but may be more efficient (e.g. for longs).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001481
1482
Guido van Rossumefbbb1c2003-04-11 18:43:06 +00001483
Guido van Rossum34343512006-11-30 22:13:52 +00001484static PyObject *
1485builtin_print(PyObject *self, PyObject *args, PyObject *kwds)
1486{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001487 static char *kwlist[] = {"sep", "end", "file", 0};
1488 static PyObject *dummy_args;
1489 PyObject *sep = NULL, *end = NULL, *file = NULL;
1490 int i, err;
Guido van Rossum34343512006-11-30 22:13:52 +00001491
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001492 if (dummy_args == NULL) {
1493 if (!(dummy_args = PyTuple_New(0)))
1494 return NULL;
1495 }
1496 if (!PyArg_ParseTupleAndKeywords(dummy_args, kwds, "|OOO:print",
1497 kwlist, &sep, &end, &file))
1498 return NULL;
1499 if (file == NULL || file == Py_None) {
1500 file = PySys_GetObject("stdout");
1501 /* sys.stdout may be None when FILE* stdout isn't connected */
1502 if (file == Py_None)
1503 Py_RETURN_NONE;
1504 }
Guido van Rossum34343512006-11-30 22:13:52 +00001505
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001506 if (sep == Py_None) {
1507 sep = NULL;
1508 }
1509 else if (sep && !PyUnicode_Check(sep)) {
1510 PyErr_Format(PyExc_TypeError,
1511 "sep must be None or a string, not %.200s",
1512 sep->ob_type->tp_name);
1513 return NULL;
1514 }
1515 if (end == Py_None) {
1516 end = NULL;
1517 }
1518 else if (end && !PyUnicode_Check(end)) {
1519 PyErr_Format(PyExc_TypeError,
1520 "end must be None or a string, not %.200s",
1521 end->ob_type->tp_name);
1522 return NULL;
1523 }
Guido van Rossum34343512006-11-30 22:13:52 +00001524
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001525 for (i = 0; i < PyTuple_Size(args); i++) {
1526 if (i > 0) {
1527 if (sep == NULL)
1528 err = PyFile_WriteString(" ", file);
1529 else
1530 err = PyFile_WriteObject(sep, file,
1531 Py_PRINT_RAW);
1532 if (err)
1533 return NULL;
1534 }
1535 err = PyFile_WriteObject(PyTuple_GetItem(args, i), file,
1536 Py_PRINT_RAW);
1537 if (err)
1538 return NULL;
1539 }
Guido van Rossum34343512006-11-30 22:13:52 +00001540
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001541 if (end == NULL)
1542 err = PyFile_WriteString("\n", file);
1543 else
1544 err = PyFile_WriteObject(end, file, Py_PRINT_RAW);
1545 if (err)
1546 return NULL;
Guido van Rossum34343512006-11-30 22:13:52 +00001547
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001548 Py_RETURN_NONE;
Guido van Rossum34343512006-11-30 22:13:52 +00001549}
1550
1551PyDoc_STRVAR(print_doc,
Georg Brandlcd5da7d2008-02-01 15:47:37 +00001552"print(value, ..., sep=' ', end='\\n', file=sys.stdout)\n\
Guido van Rossum34343512006-11-30 22:13:52 +00001553\n\
1554Prints the values to a stream, or to sys.stdout by default.\n\
1555Optional keyword arguments:\n\
1556file: a file-like object (stream); defaults to the current sys.stdout.\n\
1557sep: string inserted between values, default a space.\n\
1558end: string appended after the last value, default a newline.");
1559
1560
Guido van Rossuma88a0332007-02-26 16:59:55 +00001561static PyObject *
1562builtin_input(PyObject *self, PyObject *args)
1563{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001564 PyObject *promptarg = NULL;
1565 PyObject *fin = PySys_GetObject("stdin");
1566 PyObject *fout = PySys_GetObject("stdout");
1567 PyObject *ferr = PySys_GetObject("stderr");
1568 PyObject *tmp;
1569 long fd;
1570 int tty;
Guido van Rossuma88a0332007-02-26 16:59:55 +00001571
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001572 /* Parse arguments */
1573 if (!PyArg_UnpackTuple(args, "input", 0, 1, &promptarg))
1574 return NULL;
Guido van Rossuma88a0332007-02-26 16:59:55 +00001575
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001576 /* Check that stdin/out/err are intact */
1577 if (fin == NULL || fin == Py_None) {
1578 PyErr_SetString(PyExc_RuntimeError,
1579 "input(): lost sys.stdin");
1580 return NULL;
1581 }
1582 if (fout == NULL || fout == Py_None) {
1583 PyErr_SetString(PyExc_RuntimeError,
1584 "input(): lost sys.stdout");
1585 return NULL;
1586 }
1587 if (ferr == NULL || ferr == Py_None) {
1588 PyErr_SetString(PyExc_RuntimeError,
1589 "input(): lost sys.stderr");
1590 return NULL;
1591 }
Guido van Rossumeba76962007-05-27 09:13:28 +00001592
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001593 /* First of all, flush stderr */
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001594 tmp = _PyObject_CallMethodId(ferr, &PyId_flush, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001595 if (tmp == NULL)
1596 PyErr_Clear();
1597 else
1598 Py_DECREF(tmp);
Guido van Rossumeba76962007-05-27 09:13:28 +00001599
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001600 /* We should only use (GNU) readline if Python's sys.stdin and
1601 sys.stdout are the same as C's stdin and stdout, because we
1602 need to pass it those. */
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001603 tmp = _PyObject_CallMethodId(fin, &PyId_fileno, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001604 if (tmp == NULL) {
1605 PyErr_Clear();
1606 tty = 0;
1607 }
1608 else {
1609 fd = PyLong_AsLong(tmp);
1610 Py_DECREF(tmp);
1611 if (fd < 0 && PyErr_Occurred())
1612 return NULL;
1613 tty = fd == fileno(stdin) && isatty(fd);
1614 }
1615 if (tty) {
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001616 tmp = _PyObject_CallMethodId(fout, &PyId_fileno, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001617 if (tmp == NULL)
1618 PyErr_Clear();
1619 else {
1620 fd = PyLong_AsLong(tmp);
1621 Py_DECREF(tmp);
1622 if (fd < 0 && PyErr_Occurred())
1623 return NULL;
1624 tty = fd == fileno(stdout) && isatty(fd);
1625 }
1626 }
Guido van Rossumeba76962007-05-27 09:13:28 +00001627
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001628 /* If we're interactive, use (GNU) readline */
1629 if (tty) {
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001630 PyObject *po = NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001631 char *prompt;
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001632 char *s = NULL;
1633 PyObject *stdin_encoding = NULL, *stdin_errors = NULL;
1634 PyObject *stdout_encoding = NULL, *stdout_errors = NULL;
1635 char *stdin_encoding_str, *stdin_errors_str;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001636 PyObject *result;
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001637 size_t len;
Martin v. Löwisbd928fe2011-10-14 10:20:37 +02001638 _Py_IDENTIFIER(encoding);
Antoine Pitrou5ee9d8a2011-11-06 00:38:45 +01001639 _Py_IDENTIFIER(errors);
Martin v. Löwis4a7b5d52007-09-04 05:24:49 +00001640
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001641 stdin_encoding = _PyObject_GetAttrId(fin, &PyId_encoding);
Antoine Pitrou5ee9d8a2011-11-06 00:38:45 +01001642 stdin_errors = _PyObject_GetAttrId(fin, &PyId_errors);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001643 if (!stdin_encoding || !stdin_errors)
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001644 /* stdin is a text stream, so it must have an
1645 encoding. */
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001646 goto _readline_errors;
Victor Stinner306f0102010-05-19 01:06:22 +00001647 stdin_encoding_str = _PyUnicode_AsString(stdin_encoding);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001648 stdin_errors_str = _PyUnicode_AsString(stdin_errors);
1649 if (!stdin_encoding_str || !stdin_errors_str)
1650 goto _readline_errors;
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001651 tmp = _PyObject_CallMethodId(fout, &PyId_flush, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001652 if (tmp == NULL)
1653 PyErr_Clear();
1654 else
1655 Py_DECREF(tmp);
1656 if (promptarg != NULL) {
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001657 /* We have a prompt, encode it as stdout would */
1658 char *stdout_encoding_str, *stdout_errors_str;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001659 PyObject *stringpo;
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001660 stdout_encoding = _PyObject_GetAttrId(fout, &PyId_encoding);
Antoine Pitrou5ee9d8a2011-11-06 00:38:45 +01001661 stdout_errors = _PyObject_GetAttrId(fout, &PyId_errors);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001662 if (!stdout_encoding || !stdout_errors)
1663 goto _readline_errors;
Victor Stinner306f0102010-05-19 01:06:22 +00001664 stdout_encoding_str = _PyUnicode_AsString(stdout_encoding);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001665 stdout_errors_str = _PyUnicode_AsString(stdout_errors);
1666 if (!stdout_encoding_str || !stdout_errors_str)
1667 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001668 stringpo = PyObject_Str(promptarg);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001669 if (stringpo == NULL)
1670 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001671 po = PyUnicode_AsEncodedString(stringpo,
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001672 stdout_encoding_str, stdout_errors_str);
1673 Py_CLEAR(stdout_encoding);
1674 Py_CLEAR(stdout_errors);
1675 Py_CLEAR(stringpo);
1676 if (po == NULL)
1677 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001678 prompt = PyBytes_AsString(po);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001679 if (prompt == NULL)
1680 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001681 }
1682 else {
1683 po = NULL;
1684 prompt = "";
1685 }
1686 s = PyOS_Readline(stdin, stdout, prompt);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001687 if (s == NULL) {
1688 if (!PyErr_Occurred())
1689 PyErr_SetNone(PyExc_KeyboardInterrupt);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001690 goto _readline_errors;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001691 }
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001692
1693 len = strlen(s);
1694 if (len == 0) {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001695 PyErr_SetNone(PyExc_EOFError);
1696 result = NULL;
1697 }
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001698 else {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001699 if (len > PY_SSIZE_T_MAX) {
1700 PyErr_SetString(PyExc_OverflowError,
1701 "input: input too long");
1702 result = NULL;
1703 }
1704 else {
Victor Stinnerc0f1a1a2011-02-23 12:07:37 +00001705 len--; /* strip trailing '\n' */
1706 if (len != 0 && s[len-1] == '\r')
1707 len--; /* strip trailing '\r' */
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001708 result = PyUnicode_Decode(s, len, stdin_encoding_str,
1709 stdin_errors_str);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001710 }
1711 }
1712 Py_DECREF(stdin_encoding);
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001713 Py_DECREF(stdin_errors);
1714 Py_XDECREF(po);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001715 PyMem_FREE(s);
1716 return result;
Antoine Pitrou0d776b12011-11-06 00:34:26 +01001717 _readline_errors:
1718 Py_XDECREF(stdin_encoding);
1719 Py_XDECREF(stdout_encoding);
1720 Py_XDECREF(stdin_errors);
1721 Py_XDECREF(stdout_errors);
1722 Py_XDECREF(po);
1723 return NULL;
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001724 }
Guido van Rossumeba76962007-05-27 09:13:28 +00001725
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001726 /* Fallback if we're not interactive */
1727 if (promptarg != NULL) {
1728 if (PyFile_WriteObject(promptarg, fout, Py_PRINT_RAW) != 0)
1729 return NULL;
1730 }
Martin v. Löwisafe55bb2011-10-09 10:38:36 +02001731 tmp = _PyObject_CallMethodId(fout, &PyId_flush, "");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001732 if (tmp == NULL)
1733 PyErr_Clear();
1734 else
1735 Py_DECREF(tmp);
1736 return PyFile_GetLine(fin, -1);
Guido van Rossuma88a0332007-02-26 16:59:55 +00001737}
1738
1739PyDoc_STRVAR(input_doc,
1740"input([prompt]) -> string\n\
1741\n\
1742Read a string from standard input. The trailing newline is stripped.\n\
1743If the user hits EOF (Unix: Ctl-D, Windows: Ctl-Z+Return), raise EOFError.\n\
1744On Unix, GNU readline is used if enabled. The prompt string, if given,\n\
1745is printed without a trailing newline before reading.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001746
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001747
Guido van Rossum79f25d91997-04-29 20:08:16 +00001748static PyObject *
Martin v. Löwise3eb1f22001-08-16 13:15:00 +00001749builtin_repr(PyObject *self, PyObject *v)
Guido van Rossumc89705d1992-11-26 08:54:07 +00001750{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001751 return PyObject_Repr(v);
Guido van Rossumc89705d1992-11-26 08:54:07 +00001752}
1753
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001754PyDoc_STRVAR(repr_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001755"repr(object) -> string\n\
1756\n\
1757Return the canonical string representation of the object.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001758For most object types, eval(repr(object)) == object.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001759
1760
Guido van Rossum79f25d91997-04-29 20:08:16 +00001761static PyObject *
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001762builtin_round(PyObject *self, PyObject *args, PyObject *kwds)
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001763{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001764 static PyObject *round_str = NULL;
1765 PyObject *ndigits = NULL;
1766 static char *kwlist[] = {"number", "ndigits", 0};
1767 PyObject *number, *round;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001768
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001769 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:round",
1770 kwlist, &number, &ndigits))
1771 return NULL;
Alex Martelliae211f92007-08-22 23:21:33 +00001772
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001773 if (Py_TYPE(number)->tp_dict == NULL) {
1774 if (PyType_Ready(Py_TYPE(number)) < 0)
1775 return NULL;
1776 }
Guido van Rossum15d3d042007-08-24 02:02:45 +00001777
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001778 if (round_str == NULL) {
1779 round_str = PyUnicode_InternFromString("__round__");
1780 if (round_str == NULL)
1781 return NULL;
1782 }
Guido van Rossum2fa33db2007-08-23 22:07:24 +00001783
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001784 round = _PyType_Lookup(Py_TYPE(number), round_str);
1785 if (round == NULL) {
1786 PyErr_Format(PyExc_TypeError,
1787 "type %.100s doesn't define __round__ method",
1788 Py_TYPE(number)->tp_name);
1789 return NULL;
1790 }
Alex Martelliae211f92007-08-22 23:21:33 +00001791
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001792 if (ndigits == NULL)
1793 return PyObject_CallFunction(round, "O", number);
1794 else
1795 return PyObject_CallFunction(round, "OO", number, ndigits);
Guido van Rossum9e51f9b1993-02-12 16:29:05 +00001796}
1797
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001798PyDoc_STRVAR(round_doc,
Mark Dickinson1124e712009-01-28 21:25:58 +00001799"round(number[, ndigits]) -> number\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001800\n\
1801Round a number to a given precision in decimal digits (default 0 digits).\n\
Mark Dickinson0d748c22008-07-05 11:29:03 +00001802This returns an int when called with one argument, otherwise the\n\
Georg Brandl809ddaa2008-07-01 20:39:59 +00001803same type as the number. ndigits may be negative.");
Guido van Rossum2fa33db2007-08-23 22:07:24 +00001804
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001805
Raymond Hettinger64958a12003-12-17 20:43:33 +00001806static PyObject *
1807builtin_sorted(PyObject *self, PyObject *args, PyObject *kwds)
1808{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001809 PyObject *newlist, *v, *seq, *keyfunc=NULL, *newargs;
1810 PyObject *callable;
1811 static char *kwlist[] = {"iterable", "key", "reverse", 0};
1812 int reverse;
Martin v. Löwisbd928fe2011-10-14 10:20:37 +02001813 _Py_IDENTIFIER(sort);
Raymond Hettinger64958a12003-12-17 20:43:33 +00001814
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001815 /* args 1-3 should match listsort in Objects/listobject.c */
1816 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|Oi:sorted",
1817 kwlist, &seq, &keyfunc, &reverse))
1818 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001819
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001820 newlist = PySequence_List(seq);
1821 if (newlist == NULL)
1822 return NULL;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001823
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001824 callable = _PyObject_GetAttrId(newlist, &PyId_sort);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001825 if (callable == NULL) {
1826 Py_DECREF(newlist);
1827 return NULL;
1828 }
Georg Brandl99d7e4e2005-08-31 22:21:15 +00001829
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001830 newargs = PyTuple_GetSlice(args, 1, 4);
1831 if (newargs == NULL) {
1832 Py_DECREF(newlist);
1833 Py_DECREF(callable);
1834 return NULL;
1835 }
Raymond Hettinger64958a12003-12-17 20:43:33 +00001836
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001837 v = PyObject_Call(callable, newargs, kwds);
1838 Py_DECREF(newargs);
1839 Py_DECREF(callable);
1840 if (v == NULL) {
1841 Py_DECREF(newlist);
1842 return NULL;
1843 }
1844 Py_DECREF(v);
1845 return newlist;
Raymond Hettinger64958a12003-12-17 20:43:33 +00001846}
1847
1848PyDoc_STRVAR(sorted_doc,
Raymond Hettinger70b64fc2008-01-30 20:15:17 +00001849"sorted(iterable, key=None, reverse=False) --> new sorted list");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001850
Guido van Rossum79f25d91997-04-29 20:08:16 +00001851static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00001852builtin_vars(PyObject *self, PyObject *args)
Guido van Rossum2d951851994-08-29 12:52:16 +00001853{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001854 PyObject *v = NULL;
1855 PyObject *d;
Guido van Rossum1ae940a1995-01-02 19:04:15 +00001856
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001857 if (!PyArg_UnpackTuple(args, "vars", 0, 1, &v))
1858 return NULL;
1859 if (v == NULL) {
1860 d = PyEval_GetLocals();
1861 if (d == NULL) {
1862 if (!PyErr_Occurred())
1863 PyErr_SetString(PyExc_SystemError,
1864 "vars(): no locals!?");
1865 }
1866 else
1867 Py_INCREF(d);
1868 }
1869 else {
Martin v. Löwisbd928fe2011-10-14 10:20:37 +02001870 _Py_IDENTIFIER(__dict__);
Martin v. Löwis1ee1b6f2011-10-10 18:11:30 +02001871 d = _PyObject_GetAttrId(v, &PyId___dict__);
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001872 if (d == NULL) {
1873 PyErr_SetString(PyExc_TypeError,
1874 "vars() argument must have __dict__ attribute");
1875 return NULL;
1876 }
1877 }
1878 return d;
Guido van Rossum2d951851994-08-29 12:52:16 +00001879}
1880
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001881PyDoc_STRVAR(vars_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001882"vars([object]) -> dictionary\n\
1883\n\
1884Without arguments, equivalent to locals().\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00001885With an argument, equivalent to object.__dict__.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00001886
Alex Martellia70b1912003-04-22 08:12:33 +00001887static PyObject*
1888builtin_sum(PyObject *self, PyObject *args)
1889{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001890 PyObject *seq;
1891 PyObject *result = NULL;
1892 PyObject *temp, *item, *iter;
Alex Martellia70b1912003-04-22 08:12:33 +00001893
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001894 if (!PyArg_UnpackTuple(args, "sum", 1, 2, &seq, &result))
1895 return NULL;
Alex Martellia70b1912003-04-22 08:12:33 +00001896
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001897 iter = PyObject_GetIter(seq);
1898 if (iter == NULL)
1899 return NULL;
Alex Martellia70b1912003-04-22 08:12:33 +00001900
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001901 if (result == NULL) {
1902 result = PyLong_FromLong(0);
1903 if (result == NULL) {
1904 Py_DECREF(iter);
1905 return NULL;
1906 }
1907 } else {
1908 /* reject string values for 'start' parameter */
1909 if (PyUnicode_Check(result)) {
1910 PyErr_SetString(PyExc_TypeError,
1911 "sum() can't sum strings [use ''.join(seq) instead]");
1912 Py_DECREF(iter);
1913 return NULL;
1914 }
Benjamin Petersonce071ca2011-07-29 14:23:47 -05001915 if (PyBytes_Check(result)) {
1916 PyErr_SetString(PyExc_TypeError,
1917 "sum() can't sum bytes [use b''.join(seq) instead]");
Benjamin Peterson405f32c2011-07-29 22:43:45 -05001918 Py_DECREF(iter);
Benjamin Petersonce071ca2011-07-29 14:23:47 -05001919 return NULL;
1920 }
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001921 if (PyByteArray_Check(result)) {
1922 PyErr_SetString(PyExc_TypeError,
Benjamin Peterson4f921c22011-07-29 14:24:29 -05001923 "sum() can't sum bytearray [use b''.join(seq) instead]");
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001924 Py_DECREF(iter);
1925 return NULL;
1926 }
Guido van Rossum3172c5d2007-10-16 18:12:55 +00001927
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001928 Py_INCREF(result);
1929 }
Alex Martellia70b1912003-04-22 08:12:33 +00001930
Guido van Rossum8ce8a782007-11-01 19:42:39 +00001931#ifndef SLOW_SUM
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001932 /* Fast addition by keeping temporary sums in C instead of new Python objects.
1933 Assumes all inputs are the same type. If the assumption fails, default
1934 to the more general routine.
1935 */
1936 if (PyLong_CheckExact(result)) {
1937 int overflow;
1938 long i_result = PyLong_AsLongAndOverflow(result, &overflow);
1939 /* If this already overflowed, don't even enter the loop. */
1940 if (overflow == 0) {
1941 Py_DECREF(result);
1942 result = NULL;
1943 }
1944 while(result == NULL) {
1945 item = PyIter_Next(iter);
1946 if (item == NULL) {
1947 Py_DECREF(iter);
1948 if (PyErr_Occurred())
1949 return NULL;
1950 return PyLong_FromLong(i_result);
1951 }
1952 if (PyLong_CheckExact(item)) {
1953 long b = PyLong_AsLongAndOverflow(item, &overflow);
1954 long x = i_result + b;
1955 if (overflow == 0 && ((x^i_result) >= 0 || (x^b) >= 0)) {
1956 i_result = x;
1957 Py_DECREF(item);
1958 continue;
1959 }
1960 }
1961 /* Either overflowed or is not an int. Restore real objects and process normally */
1962 result = PyLong_FromLong(i_result);
1963 temp = PyNumber_Add(result, item);
1964 Py_DECREF(result);
1965 Py_DECREF(item);
1966 result = temp;
1967 if (result == NULL) {
1968 Py_DECREF(iter);
1969 return NULL;
1970 }
1971 }
1972 }
Guido van Rossum8ce8a782007-11-01 19:42:39 +00001973
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00001974 if (PyFloat_CheckExact(result)) {
1975 double f_result = PyFloat_AS_DOUBLE(result);
1976 Py_DECREF(result);
1977 result = NULL;
1978 while(result == NULL) {
1979 item = PyIter_Next(iter);
1980 if (item == NULL) {
1981 Py_DECREF(iter);
1982 if (PyErr_Occurred())
1983 return NULL;
1984 return PyFloat_FromDouble(f_result);
1985 }
1986 if (PyFloat_CheckExact(item)) {
1987 PyFPE_START_PROTECT("add", Py_DECREF(item); Py_DECREF(iter); return 0)
1988 f_result += PyFloat_AS_DOUBLE(item);
1989 PyFPE_END_PROTECT(f_result)
1990 Py_DECREF(item);
1991 continue;
1992 }
1993 if (PyLong_CheckExact(item)) {
1994 long value;
1995 int overflow;
1996 value = PyLong_AsLongAndOverflow(item, &overflow);
1997 if (!overflow) {
1998 PyFPE_START_PROTECT("add", Py_DECREF(item); Py_DECREF(iter); return 0)
1999 f_result += (double)value;
2000 PyFPE_END_PROTECT(f_result)
2001 Py_DECREF(item);
2002 continue;
2003 }
2004 }
2005 result = PyFloat_FromDouble(f_result);
2006 temp = PyNumber_Add(result, item);
2007 Py_DECREF(result);
2008 Py_DECREF(item);
2009 result = temp;
2010 if (result == NULL) {
2011 Py_DECREF(iter);
2012 return NULL;
2013 }
2014 }
2015 }
Guido van Rossum8ce8a782007-11-01 19:42:39 +00002016#endif
2017
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002018 for(;;) {
2019 item = PyIter_Next(iter);
2020 if (item == NULL) {
2021 /* error, or end-of-sequence */
2022 if (PyErr_Occurred()) {
2023 Py_DECREF(result);
2024 result = NULL;
2025 }
2026 break;
2027 }
2028 /* It's tempting to use PyNumber_InPlaceAdd instead of
2029 PyNumber_Add here, to avoid quadratic running time
2030 when doing 'sum(list_of_lists, [])'. However, this
2031 would produce a change in behaviour: a snippet like
Mark Dickinson9acadc52009-10-26 14:19:42 +00002032
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002033 empty = []
2034 sum([[x] for x in range(10)], empty)
Mark Dickinson9acadc52009-10-26 14:19:42 +00002035
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002036 would change the value of empty. */
2037 temp = PyNumber_Add(result, item);
2038 Py_DECREF(result);
2039 Py_DECREF(item);
2040 result = temp;
2041 if (result == NULL)
2042 break;
2043 }
2044 Py_DECREF(iter);
2045 return result;
Alex Martellia70b1912003-04-22 08:12:33 +00002046}
2047
2048PyDoc_STRVAR(sum_doc,
Georg Brandld11ae5d2008-05-16 13:27:32 +00002049"sum(iterable[, start]) -> value\n\
Alex Martellia70b1912003-04-22 08:12:33 +00002050\n\
Georg Brandld11ae5d2008-05-16 13:27:32 +00002051Returns the sum of an iterable of numbers (NOT strings) plus the value\n\
2052of parameter 'start' (which defaults to 0). When the iterable is\n\
Thomas Wouters89f507f2006-12-13 04:49:30 +00002053empty, returns start.");
Alex Martellia70b1912003-04-22 08:12:33 +00002054
2055
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002056static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002057builtin_isinstance(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002058{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002059 PyObject *inst;
2060 PyObject *cls;
2061 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002062
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002063 if (!PyArg_UnpackTuple(args, "isinstance", 2, 2, &inst, &cls))
2064 return NULL;
Guido van Rossumf5dd9141997-12-02 19:11:45 +00002065
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002066 retval = PyObject_IsInstance(inst, cls);
2067 if (retval < 0)
2068 return NULL;
2069 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002070}
2071
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002072PyDoc_STRVAR(isinstance_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002073"isinstance(object, class-or-type-or-tuple) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002074\n\
2075Return whether an object is an instance of a class or of a subclass thereof.\n\
Guido van Rossum03290ec2001-10-07 20:54:12 +00002076With a type as second argument, return whether that is the object's type.\n\
2077The form using a tuple, isinstance(x, (A, B, ...)), is a shortcut for\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002078isinstance(x, A) or isinstance(x, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002079
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002080
2081static PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002082builtin_issubclass(PyObject *self, PyObject *args)
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002083{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002084 PyObject *derived;
2085 PyObject *cls;
2086 int retval;
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002087
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002088 if (!PyArg_UnpackTuple(args, "issubclass", 2, 2, &derived, &cls))
2089 return NULL;
Guido van Rossum668213d1999-06-16 17:28:37 +00002090
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002091 retval = PyObject_IsSubclass(derived, cls);
2092 if (retval < 0)
2093 return NULL;
2094 return PyBool_FromLong(retval);
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002095}
2096
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002097PyDoc_STRVAR(issubclass_doc,
Guido van Rossum77f6a652002-04-03 22:41:51 +00002098"issubclass(C, B) -> bool\n\
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002099\n\
Walter Dörwaldd9a6ad32002-12-12 16:41:44 +00002100Return whether class C is a subclass (i.e., a derived class) of class B.\n\
2101When using a tuple as the second argument issubclass(X, (A, B, ...)),\n\
2102is a shortcut for issubclass(X, A) or issubclass(X, B) or ... (etc.).");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002103
Barry Warsawcde8b1b1997-08-22 21:14:38 +00002104
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002105typedef struct {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002106 PyObject_HEAD
2107 Py_ssize_t tuplesize;
2108 PyObject *ittuple; /* tuple of iterators */
2109 PyObject *result;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002110} zipobject;
2111
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002112static PyObject *
2113zip_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
Barry Warsawbd599b52000-08-03 15:45:29 +00002114{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002115 zipobject *lz;
2116 Py_ssize_t i;
2117 PyObject *ittuple; /* tuple of iterators */
2118 PyObject *result;
2119 Py_ssize_t tuplesize = PySequence_Length(args);
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002120
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002121 if (type == &PyZip_Type && !_PyArg_NoKeywords("zip()", kwds))
2122 return NULL;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002123
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002124 /* args must be a tuple */
2125 assert(PyTuple_Check(args));
Barry Warsawbd599b52000-08-03 15:45:29 +00002126
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002127 /* obtain iterators */
2128 ittuple = PyTuple_New(tuplesize);
2129 if (ittuple == NULL)
2130 return NULL;
2131 for (i=0; i < tuplesize; ++i) {
2132 PyObject *item = PyTuple_GET_ITEM(args, i);
2133 PyObject *it = PyObject_GetIter(item);
2134 if (it == NULL) {
2135 if (PyErr_ExceptionMatches(PyExc_TypeError))
2136 PyErr_Format(PyExc_TypeError,
2137 "zip argument #%zd must support iteration",
2138 i+1);
2139 Py_DECREF(ittuple);
2140 return NULL;
2141 }
2142 PyTuple_SET_ITEM(ittuple, i, it);
2143 }
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002144
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002145 /* create a result holder */
2146 result = PyTuple_New(tuplesize);
2147 if (result == NULL) {
2148 Py_DECREF(ittuple);
2149 return NULL;
2150 }
2151 for (i=0 ; i < tuplesize ; i++) {
2152 Py_INCREF(Py_None);
2153 PyTuple_SET_ITEM(result, i, Py_None);
2154 }
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002155
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002156 /* create zipobject structure */
2157 lz = (zipobject *)type->tp_alloc(type, 0);
2158 if (lz == NULL) {
2159 Py_DECREF(ittuple);
2160 Py_DECREF(result);
2161 return NULL;
2162 }
2163 lz->ittuple = ittuple;
2164 lz->tuplesize = tuplesize;
2165 lz->result = result;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002166
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002167 return (PyObject *)lz;
Barry Warsawbd599b52000-08-03 15:45:29 +00002168}
2169
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002170static void
2171zip_dealloc(zipobject *lz)
2172{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002173 PyObject_GC_UnTrack(lz);
2174 Py_XDECREF(lz->ittuple);
2175 Py_XDECREF(lz->result);
2176 Py_TYPE(lz)->tp_free(lz);
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002177}
2178
2179static int
2180zip_traverse(zipobject *lz, visitproc visit, void *arg)
2181{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002182 Py_VISIT(lz->ittuple);
2183 Py_VISIT(lz->result);
2184 return 0;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002185}
2186
2187static PyObject *
2188zip_next(zipobject *lz)
2189{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002190 Py_ssize_t i;
2191 Py_ssize_t tuplesize = lz->tuplesize;
2192 PyObject *result = lz->result;
2193 PyObject *it;
2194 PyObject *item;
2195 PyObject *olditem;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002196
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002197 if (tuplesize == 0)
2198 return NULL;
2199 if (Py_REFCNT(result) == 1) {
2200 Py_INCREF(result);
2201 for (i=0 ; i < tuplesize ; i++) {
2202 it = PyTuple_GET_ITEM(lz->ittuple, i);
2203 item = (*Py_TYPE(it)->tp_iternext)(it);
2204 if (item == NULL) {
2205 Py_DECREF(result);
2206 return NULL;
2207 }
2208 olditem = PyTuple_GET_ITEM(result, i);
2209 PyTuple_SET_ITEM(result, i, item);
2210 Py_DECREF(olditem);
2211 }
2212 } else {
2213 result = PyTuple_New(tuplesize);
2214 if (result == NULL)
2215 return NULL;
2216 for (i=0 ; i < tuplesize ; i++) {
2217 it = PyTuple_GET_ITEM(lz->ittuple, i);
2218 item = (*Py_TYPE(it)->tp_iternext)(it);
2219 if (item == NULL) {
2220 Py_DECREF(result);
2221 return NULL;
2222 }
2223 PyTuple_SET_ITEM(result, i, item);
2224 }
2225 }
2226 return result;
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002227}
Barry Warsawbd599b52000-08-03 15:45:29 +00002228
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002229PyDoc_STRVAR(zip_doc,
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002230"zip(iter1 [,iter2 [...]]) --> zip object\n\
Barry Warsawbd599b52000-08-03 15:45:29 +00002231\n\
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002232Return a zip object whose .__next__() method returns a tuple where\n\
2233the i-th element comes from the i-th iterable argument. The .__next__()\n\
2234method continues until the shortest iterable in the argument sequence\n\
Georg Brandlced51db2008-12-04 18:28:38 +00002235is exhausted and then it raises StopIteration.");
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002236
2237PyTypeObject PyZip_Type = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002238 PyVarObject_HEAD_INIT(&PyType_Type, 0)
2239 "zip", /* tp_name */
2240 sizeof(zipobject), /* tp_basicsize */
2241 0, /* tp_itemsize */
2242 /* methods */
2243 (destructor)zip_dealloc, /* tp_dealloc */
2244 0, /* tp_print */
2245 0, /* tp_getattr */
2246 0, /* tp_setattr */
2247 0, /* tp_reserved */
2248 0, /* tp_repr */
2249 0, /* tp_as_number */
2250 0, /* tp_as_sequence */
2251 0, /* tp_as_mapping */
2252 0, /* tp_hash */
2253 0, /* tp_call */
2254 0, /* tp_str */
2255 PyObject_GenericGetAttr, /* tp_getattro */
2256 0, /* tp_setattro */
2257 0, /* tp_as_buffer */
2258 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
2259 Py_TPFLAGS_BASETYPE, /* tp_flags */
2260 zip_doc, /* tp_doc */
2261 (traverseproc)zip_traverse, /* tp_traverse */
2262 0, /* tp_clear */
2263 0, /* tp_richcompare */
2264 0, /* tp_weaklistoffset */
2265 PyObject_SelfIter, /* tp_iter */
2266 (iternextfunc)zip_next, /* tp_iternext */
2267 0, /* tp_methods */
2268 0, /* tp_members */
2269 0, /* tp_getset */
2270 0, /* tp_base */
2271 0, /* tp_dict */
2272 0, /* tp_descr_get */
2273 0, /* tp_descr_set */
2274 0, /* tp_dictoffset */
2275 0, /* tp_init */
2276 PyType_GenericAlloc, /* tp_alloc */
2277 zip_new, /* tp_new */
2278 PyObject_GC_Del, /* tp_free */
Raymond Hettinger736c0ab2008-03-13 02:09:15 +00002279};
Barry Warsawbd599b52000-08-03 15:45:29 +00002280
2281
Guido van Rossum79f25d91997-04-29 20:08:16 +00002282static PyMethodDef builtin_methods[] = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002283 {"__build_class__", (PyCFunction)builtin___build_class__,
2284 METH_VARARGS | METH_KEYWORDS, build_class_doc},
2285 {"__import__", (PyCFunction)builtin___import__, METH_VARARGS | METH_KEYWORDS, import_doc},
2286 {"abs", builtin_abs, METH_O, abs_doc},
2287 {"all", builtin_all, METH_O, all_doc},
2288 {"any", builtin_any, METH_O, any_doc},
2289 {"ascii", builtin_ascii, METH_O, ascii_doc},
2290 {"bin", builtin_bin, METH_O, bin_doc},
Antoine Pitroue71362d2010-11-27 22:00:11 +00002291 {"callable", builtin_callable, METH_O, callable_doc},
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002292 {"chr", builtin_chr, METH_VARARGS, chr_doc},
2293 {"compile", (PyCFunction)builtin_compile, METH_VARARGS | METH_KEYWORDS, compile_doc},
2294 {"delattr", builtin_delattr, METH_VARARGS, delattr_doc},
2295 {"dir", builtin_dir, METH_VARARGS, dir_doc},
2296 {"divmod", builtin_divmod, METH_VARARGS, divmod_doc},
2297 {"eval", builtin_eval, METH_VARARGS, eval_doc},
2298 {"exec", builtin_exec, METH_VARARGS, exec_doc},
2299 {"format", builtin_format, METH_VARARGS, format_doc},
2300 {"getattr", builtin_getattr, METH_VARARGS, getattr_doc},
2301 {"globals", (PyCFunction)builtin_globals, METH_NOARGS, globals_doc},
2302 {"hasattr", builtin_hasattr, METH_VARARGS, hasattr_doc},
2303 {"hash", builtin_hash, METH_O, hash_doc},
2304 {"hex", builtin_hex, METH_O, hex_doc},
2305 {"id", builtin_id, METH_O, id_doc},
2306 {"input", builtin_input, METH_VARARGS, input_doc},
2307 {"isinstance", builtin_isinstance, METH_VARARGS, isinstance_doc},
2308 {"issubclass", builtin_issubclass, METH_VARARGS, issubclass_doc},
2309 {"iter", builtin_iter, METH_VARARGS, iter_doc},
2310 {"len", builtin_len, METH_O, len_doc},
2311 {"locals", (PyCFunction)builtin_locals, METH_NOARGS, locals_doc},
2312 {"max", (PyCFunction)builtin_max, METH_VARARGS | METH_KEYWORDS, max_doc},
2313 {"min", (PyCFunction)builtin_min, METH_VARARGS | METH_KEYWORDS, min_doc},
2314 {"next", (PyCFunction)builtin_next, METH_VARARGS, next_doc},
2315 {"oct", builtin_oct, METH_O, oct_doc},
2316 {"ord", builtin_ord, METH_O, ord_doc},
2317 {"pow", builtin_pow, METH_VARARGS, pow_doc},
2318 {"print", (PyCFunction)builtin_print, METH_VARARGS | METH_KEYWORDS, print_doc},
2319 {"repr", builtin_repr, METH_O, repr_doc},
2320 {"round", (PyCFunction)builtin_round, METH_VARARGS | METH_KEYWORDS, round_doc},
2321 {"setattr", builtin_setattr, METH_VARARGS, setattr_doc},
2322 {"sorted", (PyCFunction)builtin_sorted, METH_VARARGS | METH_KEYWORDS, sorted_doc},
2323 {"sum", builtin_sum, METH_VARARGS, sum_doc},
2324 {"vars", builtin_vars, METH_VARARGS, vars_doc},
2325 {NULL, NULL},
Guido van Rossum3f5da241990-12-20 15:06:42 +00002326};
2327
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002328PyDoc_STRVAR(builtin_doc,
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002329"Built-in functions, exceptions, and other objects.\n\
2330\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00002331Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
Guido van Rossumf9d9c6c1998-06-26 21:23:49 +00002332
Martin v. Löwis1a214512008-06-11 05:26:20 +00002333static struct PyModuleDef builtinsmodule = {
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002334 PyModuleDef_HEAD_INIT,
2335 "builtins",
2336 builtin_doc,
2337 -1, /* multiple "initialization" just copies the module dict. */
2338 builtin_methods,
2339 NULL,
2340 NULL,
2341 NULL,
2342 NULL
Martin v. Löwis1a214512008-06-11 05:26:20 +00002343};
2344
2345
Guido van Rossum25ce5661997-08-02 03:10:38 +00002346PyObject *
Thomas Woutersf70ef4f2000-07-22 18:47:25 +00002347_PyBuiltin_Init(void)
Guido van Rossum25ce5661997-08-02 03:10:38 +00002348{
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002349 PyObject *mod, *dict, *debug;
2350 mod = PyModule_Create(&builtinsmodule);
2351 if (mod == NULL)
2352 return NULL;
2353 dict = PyModule_GetDict(mod);
Tim Peters4b7625e2001-09-13 21:37:17 +00002354
Tim Peters7571a0f2003-03-23 17:52:28 +00002355#ifdef Py_TRACE_REFS
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002356 /* "builtins" exposes a number of statically allocated objects
2357 * that, before this code was added in 2.3, never showed up in
2358 * the list of "all objects" maintained by Py_TRACE_REFS. As a
2359 * result, programs leaking references to None and False (etc)
2360 * couldn't be diagnosed by examining sys.getobjects(0).
2361 */
Tim Peters7571a0f2003-03-23 17:52:28 +00002362#define ADD_TO_ALL(OBJECT) _Py_AddToAllObjects((PyObject *)(OBJECT), 0)
2363#else
2364#define ADD_TO_ALL(OBJECT) (void)0
2365#endif
2366
Tim Peters4b7625e2001-09-13 21:37:17 +00002367#define SETBUILTIN(NAME, OBJECT) \
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002368 if (PyDict_SetItemString(dict, NAME, (PyObject *)OBJECT) < 0) \
2369 return NULL; \
2370 ADD_TO_ALL(OBJECT)
Tim Peters4b7625e2001-09-13 21:37:17 +00002371
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002372 SETBUILTIN("None", Py_None);
2373 SETBUILTIN("Ellipsis", Py_Ellipsis);
2374 SETBUILTIN("NotImplemented", Py_NotImplemented);
2375 SETBUILTIN("False", Py_False);
2376 SETBUILTIN("True", Py_True);
2377 SETBUILTIN("bool", &PyBool_Type);
2378 SETBUILTIN("memoryview", &PyMemoryView_Type);
2379 SETBUILTIN("bytearray", &PyByteArray_Type);
2380 SETBUILTIN("bytes", &PyBytes_Type);
2381 SETBUILTIN("classmethod", &PyClassMethod_Type);
2382 SETBUILTIN("complex", &PyComplex_Type);
2383 SETBUILTIN("dict", &PyDict_Type);
2384 SETBUILTIN("enumerate", &PyEnum_Type);
2385 SETBUILTIN("filter", &PyFilter_Type);
2386 SETBUILTIN("float", &PyFloat_Type);
2387 SETBUILTIN("frozenset", &PyFrozenSet_Type);
2388 SETBUILTIN("property", &PyProperty_Type);
2389 SETBUILTIN("int", &PyLong_Type);
2390 SETBUILTIN("list", &PyList_Type);
2391 SETBUILTIN("map", &PyMap_Type);
2392 SETBUILTIN("object", &PyBaseObject_Type);
2393 SETBUILTIN("range", &PyRange_Type);
2394 SETBUILTIN("reversed", &PyReversed_Type);
2395 SETBUILTIN("set", &PySet_Type);
2396 SETBUILTIN("slice", &PySlice_Type);
2397 SETBUILTIN("staticmethod", &PyStaticMethod_Type);
2398 SETBUILTIN("str", &PyUnicode_Type);
2399 SETBUILTIN("super", &PySuper_Type);
2400 SETBUILTIN("tuple", &PyTuple_Type);
2401 SETBUILTIN("type", &PyType_Type);
2402 SETBUILTIN("zip", &PyZip_Type);
2403 debug = PyBool_FromLong(Py_OptimizeFlag == 0);
2404 if (PyDict_SetItemString(dict, "__debug__", debug) < 0) {
2405 Py_XDECREF(debug);
2406 return NULL;
2407 }
2408 Py_XDECREF(debug);
Barry Warsaw757af0e1997-08-29 22:13:51 +00002409
Antoine Pitrouf95a1b32010-05-09 15:52:27 +00002410 return mod;
Tim Peters7571a0f2003-03-23 17:52:28 +00002411#undef ADD_TO_ALL
Tim Peters4b7625e2001-09-13 21:37:17 +00002412#undef SETBUILTIN
Guido van Rossum3f5da241990-12-20 15:06:42 +00002413}