[Python-checkins] CVS: python/dist/src/Doc/lib libstdtypes.tex,1.72,1.73

2001年10月26日 11:57:16 -0700

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv29654/lib
Modified Files:
	libstdtypes.tex 
Log Message:
Explain what [].insert() does when the target index is negative.
Index: libstdtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstdtypes.tex,v
retrieving revision 1.72
retrieving revision 1.73
diff -C2 -d -r1.72 -r1.73
*** libstdtypes.tex	2001年10月20日 04:24:09	1.72
--- libstdtypes.tex	2001年10月26日 18:57:14	1.73
***************
*** 840,852 ****
 \lineiii{\var{s}.insert(\var{i}, \var{x})}
 	{same as \code{\var{s}[\var{i}:\var{i}] = [\var{x}]}
! 	 if \code{\var{i} >= 0}}{}
 \lineiii{\var{s}.pop(\optional{\var{i}})}
! {same as \code{\var{x} = \var{s}[\var{i}]; del \var{s}[\var{i}]; return \var{x}}}{(4)}
 \lineiii{\var{s}.remove(\var{x})}
 	{same as \code{del \var{s}[\var{s}.index(\var{x})]}}{(3)}
 \lineiii{\var{s}.reverse()}
! 	{reverses the items of \var{s} in place}{(5)}
 \lineiii{\var{s}.sort(\optional{\var{cmpfunc}})}
! 	{sort the items of \var{s} in place}{(5), (6)}
 \end{tableiii}
 \indexiv{operations on}{mutable}{sequence}{types}
--- 840,852 ----
 \lineiii{\var{s}.insert(\var{i}, \var{x})}
 	{same as \code{\var{s}[\var{i}:\var{i}] = [\var{x}]}
! 	 if \code{\var{i} >= 0}}{(4)}
 \lineiii{\var{s}.pop(\optional{\var{i}})}
! {same as \code{\var{x} = \var{s}[\var{i}]; del \var{s}[\var{i}]; return \var{x}}}{(5)}
 \lineiii{\var{s}.remove(\var{x})}
 	{same as \code{del \var{s}[\var{s}.index(\var{x})]}}{(3)}
 \lineiii{\var{s}.reverse()}
! 	{reverses the items of \var{s} in place}{(6)}
 \lineiii{\var{s}.sort(\optional{\var{cmpfunc}})}
! 	{sort the items of \var{s} in place}{(6), (7)}
 \end{tableiii}
 \indexiv{operations on}{mutable}{sequence}{types}
***************
*** 875,888 ****
 \var{s}.

! \item[(4)] The \method{pop()} method is only supported by the list and
 array types. The optional argument \var{i} defaults to \code{-1},
 so that by default the last item is removed and returned.

! \item[(5)] The \method{sort()} and \method{reverse()} methods modify the
 list in place for economy of space when sorting or reversing a large
 list. To remind you that they operate by side effect, they don't return
 the sorted or reversed list.

! \item[(6)] The \method{sort()} method takes an optional argument
 specifying a comparison function of two arguments (list items) which
 should return a negative, zero or positive number depending on whether
--- 875,892 ----
 \var{s}.

! \item[(4)] When a negative index is passed as the first parameter to
! the \method{insert()} method, the new element is prepended to the
! sequence.
! 
! \item[(5)] The \method{pop()} method is only supported by the list and
 array types. The optional argument \var{i} defaults to \code{-1},
 so that by default the last item is removed and returned.

! \item[(6)] The \method{sort()} and \method{reverse()} methods modify the
 list in place for economy of space when sorting or reversing a large
 list. To remind you that they operate by side effect, they don't return
 the sorted or reversed list.

! \item[(7)] The \method{sort()} method takes an optional argument
 specifying a comparison function of two arguments (list items) which
 should return a negative, zero or positive number depending on whether