mirror of
				https://github.com/python/cpython.git
				synced 2025-10-31 13:41:24 +00:00 
			
		
		
		
	Document the new list.extend() method. Interesting enough, the
canonical definition of extend() is very similar to append() except that the former doesn't list-ify the argument!
This commit is contained in:
		
							parent
							
								
									dedf6d6804
								
							
						
					
					
						commit
						afd974c2ab
					
				
					 1 changed files with 6 additions and 0 deletions
				
			
		|  | @ -452,6 +452,8 @@ The following operations are defined on mutable sequence types (where | |||
| 	{same as \code{\var{s}[\var{i}:\var{j}] = []}}{} | ||||
|   \lineiii{\var{s}.append(\var{x})} | ||||
| 	{same as \code{\var{s}[len(\var{s}):len(\var{s})] = [\var{x}]}}{} | ||||
|   \lineiii{\var{s}.extend(\var{x})} | ||||
|         {same as \code{\var{s}[len(\var{s}):len(\var{s})] = \var{x}}}{(5)} | ||||
|   \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})} | ||||
|  | @ -476,6 +478,7 @@ The following operations are defined on mutable sequence types (where | |||
| \stindex{del} | ||||
| \withsubitem{(list method)}{% | ||||
|   \ttindex{append}% | ||||
|   \ttindex{extend}% | ||||
|   \ttindex{count}% | ||||
|   \ttindex{index}% | ||||
|   \ttindex{insert}% | ||||
|  | @ -509,6 +512,9 @@ by other mutable sequence types than lists. | |||
| The optional argument \var{i} defaults to \code{-1}, so that | ||||
| by default the last item is removed and returned. | ||||
| 
 | ||||
| \item[(5)] Raises an exception when \var{x} is not a list object.  The  | ||||
| \method{extend()} method is experimental and not supported by mutable types | ||||
| other than lists. | ||||
| \end{description} | ||||
| 
 | ||||
| 
 | ||||
|  |  | |||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue
	
	 Barry Warsaw
						Barry Warsaw