[Python-checkins] python/dist/src/Doc/lib libstdtypes.tex, 1.138, 1.139

Wed Oct 29 01:54:44 EST 2003

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv6236/Doc/lib
Modified Files:
	libstdtypes.tex 
Log Message:
Add list.sorted() classmethod.
Index: libstdtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libstdtypes.tex,v
retrieving revision 1.138
retrieving revision 1.139
diff -C2 -d -r1.138 -r1.139
*** libstdtypes.tex	22 Oct 2003 02:56:40 -0000	1.138
--- libstdtypes.tex	29 Oct 2003 06:54:42 -0000	1.139
***************
*** 630,634 ****
 \begin{methoddesc}[string]{istitle}{}
 Return true if the string is a titlecased string and there is at least one
! character, i.e. uppercase characters may only follow uncased
 characters and lowercase characters only cased ones. Return false
 otherwise.
--- 630,634 ----
 \begin{methoddesc}[string]{istitle}{}
 Return true if the string is a titlecased string and there is at least one
! character, for example uppercase characters may only follow uncased
 characters and lowercase characters only cased ones. Return false
 otherwise.
***************
*** 976,979 ****
--- 976,982 ----
 \optional{, \var{reverse}=False}}})}
 	{sort the items of \var{s} in place}{(7), (8), (9), (10)}
+ \lineiii{\var{s}.sorted(\var{iterable}\optional{, \var{cmp}=None\optional{, \var{key}=None
+ \optional{, \var{reverse}=False}}})}
+ 	{return a new sorted list from the items in \var{iterable}}{(8), (9), (11)} 
 \end{tableiii}
 \indexiv{operations on}{mutable}{sequence}{types}
***************
*** 1025,1030 ****
 the sorted or reversed list.

! \item[(8)] The \method{sort()} method takes optional arguments for
! controlling the comparisions.

 \var{cmp} specifies a custom comparison function of two arguments
--- 1028,1033 ----
 the sorted or reversed list.

! \item[(8)] The \method{sort()} and \method{sorted()} methods take optional
! arguments for controlling the comparisions.

 \var{cmp} specifies a custom comparison function of two arguments
***************
*** 1053,1057 ****

 \item[(9)] Starting with Python 2.3, the \method{sort()} method is
! guaranteed to be stable. A sort is stable if it guarantees not to
 change the relative order of elements that compare equal --- this is
 helpful for sorting in multiple passes (for example, sort by
--- 1056,1061 ----

 \item[(9)] Starting with Python 2.3, the \method{sort()} method is
! guaranteed to be stable. Starting with Python 2.4, the \method{sorted()}
! method is also guaranteed to be stable. A sort is stable if it does not
 change the relative order of elements that compare equal --- this is
 helpful for sorting in multiple passes (for example, sort by
***************
*** 1063,1066 ****
--- 1067,1073 ----
 \exception{ValueError} if it can detect that the list has been
 mutated during a sort.
+ 
+ \item[(11)] \method{sorted()} is a class method that returns a new list.
+ \versionadded{2.4}
 \end{description}