[docs] [issue9802] Document 'stability' of builtin min() and max()
report at bugs.python.org
Wed Sep 8 21:30:31 CEST 2010
New submission from Matthew Woodcraft <matthew at woodcraft.me.uk>:
In CPython, the builtin max() and min() have the property that if there are items with equal keys, the first item is returned. From a quick look at their source, I think this is true for Jython and IronPython too.
I propose making this a documented guarantee.
On Python-dev, Raymond Hettinger said:
That seems like a reasonable request. This behavior has been around for a very long time is unlikely to change. Elsewhere, we've made efforts to document sort stability (i.e. sorted(), heapq.nlargest(), heapq.nsmallest, merge(), etc).
I'm attaching a patch with a concrete suggestion for a change to
functions.rst, modelled on the documentation of heapq.nlargest().
assignee: docs at python
nosy: docs at python, mattheww
title: Document 'stability' of builtin min() and max()
type: feature request
Added file: http://bugs.python.org/file18802/maxmin.patch
Python tracker <report at bugs.python.org>
More information about the docs