[3.12] gh-121977: Add tips for handling unhashable data (GH-122075) (#122077)

gh-121977: Add tips for handling unhashable data (GH-122075)
(cherry picked from commit ebc18abbf3)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2024-07-21 08:00:20 +02:00 committed by GitHub
parent 966eff9ce4
commit 5f46a726ea
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -408,6 +408,12 @@ However, for reading convenience, most of the examples show sorted sequences.
>>> mode(["red", "blue", "blue", "red", "green", "red", "red"])
'red'
Only hashable inputs are supported. To handle type :class:`set`,
consider casting to :class:`frozenset`. To handle type :class:`list`,
consider casting to :class:`tuple`. For mixed or nested inputs, consider
using this slower quadratic algorithm that only depends on equality tests:
``max(data, key=data.count)``.
.. versionchanged:: 3.8
Now handles multimodal datasets by returning the first mode encountered.
Formerly, it raised :exc:`StatisticsError` when more than one mode was