mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-04 16:43:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

Added doc strings for methods and a new pop() method.

Browse source
This commit is contained in:
Guido van Rossum 1998-06-30 15:36:32 +00:00
parent cd90509d58
commit 3dd7f3fef0
1 changed files with 54 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

61
Objects/listobject.c
View file

@ -572,6 +572,35 @@ listappend(self, args)
return ins(self, (int) self->ob_size, v); return ins(self, (int) self->ob_size, v);
} }
static PyObject *
listpop(self, args)
PyListObject *self;
PyObject *args;
{
int i = -1;
PyObject *v;
if (!PyArg_ParseTuple(args, "|i", &i))
return NULL;
if (self->ob_size == 0) {
/* Special-case most common failure cause */
PyErr_SetString(PyExc_IndexError, "pop from empty list");
return NULL;
}
if (i < 0)
i += self->ob_size;
if (i < 0 || i >= self->ob_size) {
PyErr_SetString(PyExc_IndexError, "pop index out of range");
return NULL;
}
v = self->ob_item[i];
Py_INCREF(v);
if (list_ass_slice(self, i, i+1, (PyObject *)NULL) != 0) {
Py_DECREF(v);
return NULL;
}
return v;
}
/* New quicksort implementation for arrays of object pointers. /* New quicksort implementation for arrays of object pointers.
Thanks to discussions with Tim Peters. */ Thanks to discussions with Tim Peters. */
@ -1282,14 +1311,32 @@ listremove(self, args)
return NULL; return NULL;
} }
static char append_doc[] =
"L.append(object) -- append object to end";
static char insert_doc[] =
"L.insert(index, object) -- insert object before index";
static char pop_doc[] =
"L.pop([index]) -> item -- remove and return item at index (default last)";
static char remove_doc[] =
"L.remove(value) -- remove first occurrence of value";
static char index_doc[] =
"L.index(value) -> integer -- return index of first occurrence of value";
static char count_doc[] =
"L.count(value) -> integer -- return number of occurrences of value";
static char reverse_doc[] =
"L.reverse() -- reverse *IN PLACE*";
static char sort_doc[] =
"L.sort([cmpfunc]) -- sort *IN PLACE*; if given, cmpfunc(x, y) -> -1, 0, 1";
static PyMethodDef list_methods[] = { static PyMethodDef list_methods[] = {
{"append", (PyCFunction)listappend}, {"append", (PyCFunction)listappend, 0, append_doc},
{"insert", (PyCFunction)listinsert}, {"insert", (PyCFunction)listinsert, 0, insert_doc},
{"remove", (PyCFunction)listremove}, {"pop", (PyCFunction)listpop, 1, pop_doc},
{"index", (PyCFunction)listindex}, {"remove", (PyCFunction)listremove, 0, remove_doc},
{"count", (PyCFunction)listcount}, {"index", (PyCFunction)listindex, 0, index_doc},
{"reverse", (PyCFunction)listreverse}, {"count", (PyCFunction)listcount, 0, count_doc},
{"sort", (PyCFunction)listsort, 0}, {"reverse", (PyCFunction)listreverse, 0, reverse_doc},
{"sort", (PyCFunction)listsort, 0, sort_doc},
{NULL, NULL} /* sentinel */ {NULL, NULL} /* sentinel */
}; };