summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2016-11-21 23:13:38 (GMT)
committerRaymond Hettinger <python@rcn.com>2016-11-21 23:13:38 (GMT)
commit1f56e25412dbb538c1ea707daddefe18ccd1adff (patch)
tree1c316c2d205893b9b7681a7d1aa6575c657a7bdf /Doc/tutorial
parent4878d001b173788c9dceb756c6e76aa5ed111967 (diff)
parent7f946195558b3681b81707c52b721d067373acee (diff)
downloadcpython-1f56e25412dbb538c1ea707daddefe18ccd1adff.zip
cpython-1f56e25412dbb538c1ea707daddefe18ccd1adff.tar.gz
cpython-1f56e25412dbb538c1ea707daddefe18ccd1adff.tar.bz2
merge
Diffstat (limited to 'Doc/tutorial')
-rw-r--r--Doc/tutorial/datastructures.rst13
1 files changed, 10 insertions, 3 deletions
diff --git a/Doc/tutorial/datastructures.rst b/Doc/tutorial/datastructures.rst
index b39bdf4..83a1f9b 100644
--- a/Doc/tutorial/datastructures.rst
+++ b/Doc/tutorial/datastructures.rst
@@ -60,11 +60,16 @@ objects:
Remove all items from the list. Equivalent to ``del a[:]``.
-.. method:: list.index(x)
+.. method:: list.index(x[, start[, end]])
:noindex:
- Return the index in the list of the first item whose value is *x*. It is an
- error if there is no such item.
+ Return zero-based index in the list of the first item whose value is *x*.
+ Raises a :exc:`ValueError` if there is no such item.
+
+ The optional arguments *start* and *end* are interpreted as in the slice
+ notation and are used to limit the search to a particular subsequence of
+ *x*. The returned index is computed relative to the beginning of the full
+ sequence rather than the *start* argument.
.. method:: list.count(x)
@@ -103,6 +108,8 @@ An example that uses most of the list methods::
[66.25, 333, -1, 333, 1, 1234.5, 333]
>>> a.index(333)
1
+ >>> a.index(333, 2) # search for 333 starting at index 2
+ 2
>>> a.remove(333)
>>> a
[66.25, -1, 333, 1, 1234.5, 333]