mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-13 07:26:31 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Small markup and wording tweaks for the sorting-howto.

Browse source
This commit is contained in:
Raymond Hettinger 2011-02-06 06:11:29 +00:00
parent 98135d07e7
commit 810cd3479f
1 changed files with 6 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

12
Doc/howto/sorting.rst
View file

@ -23,7 +23,7 @@ returns a new sorted list::
>>> sorted([5, 2, 3, 1, 4]) >>> sorted([5, 2, 3, 1, 4])
[1, 2, 3, 4, 5] [1, 2, 3, 4, 5]
You can also use the :meth:`list.sort` method of a list. It modifies the list You can also use the :meth:`list.sort` method. It modifies the list
in-place (and returns *None* to avoid confusion). Usually it's less convenient in-place (and returns *None* to avoid confusion). Usually it's less convenient
than :func:`sorted` - but if you don't need the original list, it's slightly than :func:`sorted` - but if you don't need the original list, it's slightly
more efficient. more efficient.
@ -87,9 +87,9 @@ Operator Module Functions
========================= =========================
The key-function patterns shown above are very common, so Python provides The key-function patterns shown above are very common, so Python provides
convenience functions to make accessor functions easier and faster. The operator convenience functions to make accessor functions easier and faster. The
module has :func:`operator.itemgetter`, :func:`operator.attrgetter`, and :mod:`operator` module has :func:`~operator.itemgetter`,
an :func:`operator.methodcaller` function. :func:`~operator.attrgetter`, and an :func:`~operator.methodcaller` function.
Using those functions, the above examples become simpler and faster: Using those functions, the above examples become simpler and faster:
@ -248,7 +248,7 @@ To convert to a key function, just wrap the old comparison function:
[5, 4, 3, 2, 1] [5, 4, 3, 2, 1]
In Python 3.2, the :func:`functools.cmp_to_key` function was added to the In Python 3.2, the :func:`functools.cmp_to_key` function was added to the
functools module in the standard library. :mod:`functools` module in the standard library.
Odd and Ends Odd and Ends
============ ============
@ -256,7 +256,7 @@ Odd and Ends
* For locale aware sorting, use :func:`locale.strxfrm` for a key function or * For locale aware sorting, use :func:`locale.strxfrm` for a key function or
:func:`locale.strcoll` for a comparison function. :func:`locale.strcoll` for a comparison function.
* The *reverse* parameter still maintains sort stability (i.e. records with * The *reverse* parameter still maintains sort stability (so that records with
equal keys retain the original order). Interestingly, that effect can be equal keys retain the original order). Interestingly, that effect can be
simulated without the parameter by using the builtin :func:`reversed` function simulated without the parameter by using the builtin :func:`reversed` function
twice: twice: