Improve the documented advice on how to best use heapq.heapreplace().

This commit is contained in:
Raymond Hettinger 2004-06-20 09:07:53 +00:00
parent 1761a7cc8b
commit 28224f897a
3 changed files with 10 additions and 3 deletions

View file

@ -59,7 +59,11 @@ If the heap is empty, \exception{IndexError} is raised.
This is more efficient than \function{heappop()} followed
by \function{heappush()}, and can be more appropriate when using
a fixed-size heap. Note that the value returned may be larger
than \var{item}! That constrains reasonable uses of this routine.
than \var{item}! That constrains reasonable uses of this routine
unless written as part of a larger expression:
\begin{verbatim}
result = item <= heap[0] and item or heapreplace(heap, item)
\end{verbatim}
\end{funcdesc}
Example of use: