diff options
author | Ezio Melotti <ezio.melotti@gmail.com> | 2014-10-28 11:57:11 (GMT) |
---|---|---|
committer | Ezio Melotti <ezio.melotti@gmail.com> | 2014-10-28 11:57:11 (GMT) |
commit | 9f8a5b1abd7ef3fe387daf3ddeb6fe1bc11240b3 (patch) | |
tree | 644055ff4e1c6764873c916a88dcbcdbd59cf212 /Doc/library/heapq.rst | |
parent | 7876f72f6afe2ac632726770848c444aeb3865cb (diff) | |
download | cpython-9f8a5b1abd7ef3fe387daf3ddeb6fe1bc11240b3.zip cpython-9f8a5b1abd7ef3fe387daf3ddeb6fe1bc11240b3.tar.gz cpython-9f8a5b1abd7ef3fe387daf3ddeb6fe1bc11240b3.tar.bz2 |
#22237: document that sorted() is guaranteed to be stable. Initial patch by Martin Panter.
Diffstat (limited to 'Doc/library/heapq.rst')
-rw-r--r-- | Doc/library/heapq.rst | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/Doc/library/heapq.rst b/Doc/library/heapq.rst index e8acd6c..617e3fe 100644 --- a/Doc/library/heapq.rst +++ b/Doc/library/heapq.rst @@ -136,7 +136,6 @@ pushing all values onto a heap and then popping off the smallest values one at a time:: >>> def heapsort(iterable): - ... 'Equivalent to sorted(iterable)' ... h = [] ... for value in iterable: ... heappush(h, value) @@ -145,6 +144,9 @@ time:: >>> heapsort([1, 3, 5, 7, 9, 2, 4, 6, 8, 0]) [0, 1, 2, 3, 4, 5, 6, 7, 8, 9] +This is similar to ``sorted(iterable)``, but unlike :func:`sorted`, this +implementation is not stable. + Heap elements can be tuples. This is useful for assigning comparison values (such as task priorities) alongside the main record being tracked:: |