diff options
author | Walter Dörwald <walter@livinglogic.de> | 2003-06-17 16:19:56 (GMT) |
---|---|---|
committer | Walter Dörwald <walter@livinglogic.de> | 2003-06-17 16:19:56 (GMT) |
commit | 93719b56ed6ace04680ad909eb32378c5c1f07a3 (patch) | |
tree | 2ca5f617991c86454023c9612c188c13239fb370 /Doc | |
parent | e0a1bb6341ea87d811947c84dcce3d84147a93fd (diff) | |
download | cpython-93719b56ed6ace04680ad909eb32378c5c1f07a3.zip cpython-93719b56ed6ace04680ad909eb32378c5c1f07a3.tar.gz cpython-93719b56ed6ace04680ad909eb32378c5c1f07a3.tar.bz2 |
Updated documentation for the new slice arguments for list.index().
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/lib/libstdtypes.tex | 11 |
1 files changed, 8 insertions, 3 deletions
diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex index 38440fe..4c1dcbd 100644 --- a/Doc/lib/libstdtypes.tex +++ b/Doc/lib/libstdtypes.tex @@ -942,8 +942,9 @@ The following operations are defined on mutable sequence types (where {same as \code{\var{s}[len(\var{s}):len(\var{s})] = \var{x}}}{(3)} \lineiii{\var{s}.count(\var{x})} {return number of \var{i}'s for which \code{\var{s}[\var{i}] == \var{x}}}{} - \lineiii{\var{s}.index(\var{x})} - {return smallest \var{i} such that \code{\var{s}[\var{i}] == \var{x}}}{(4)} + \lineiii{\var{s}.index(\var{x}\optional{, \var{i}\optional{, \var{j}}})} + {return smallest \var{k} such that \code{\var{s}[\var{k}] == \var{x}} and + \code{\var{i} <= \var{k} < \var{j}}}{(4)} \lineiii{\var{s}.insert(\var{i}, \var{x})} {same as \code{\var{s}[\var{i}:\var{i}] = [\var{x}]}}{(5)} \lineiii{\var{s}.pop(\optional{\var{i}})} @@ -982,7 +983,11 @@ Notes: mutable sequence types other than lists. \item[(4)] Raises \exception{ValueError} when \var{x} is not found in - \var{s}. + \var{s}. When a negative index is passed as the second or third parameter + to the \method{index()} method, the list length is added, as for slice + indices. If it is still negative, it is truncated to zero, as for + slice indices. \versionchanged[Previously, \method{index()} didn't + have arguments for specifying start and stop positions]{2.3} \item[(5)] When a negative index is passed as the first parameter to the \method{insert()} method, the list length is added, as for slice |