]> granicus.if.org Git - python/commitdiff
Updated documentation for the new slice arguments for list.index().
authorWalter Dörwald <walter@livinglogic.de>
Tue, 17 Jun 2003 16:19:56 +0000 (16:19 +0000)
committerWalter Dörwald <walter@livinglogic.de>
Tue, 17 Jun 2003 16:19:56 +0000 (16:19 +0000)
Doc/lib/libstdtypes.tex

index 38440feae8a9ca4e57006a40d1e0b1cad09bd93f..4c1dcbdd58533116a6fe25dc0016e3ae5991bd7d 100644 (file)
@@ -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