[Python-checkins] bpo-34123: Fix missed documentation update for dict.popitem(). (GH-8292)
Raymond Hettinger
webhook-mailer at python.org
Mon Jul 16 20:20:20 EDT 2018
https://github.com/python/cpython/commit/01b7d5898262dbe0e9edb321b3be9a34da196f6f
commit: 01b7d5898262dbe0e9edb321b3be9a34da196f6f
branch: master
author: Raymond Hettinger <rhettinger at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018-07-16T17:20:15-07:00
summary:
bpo-34123: Fix missed documentation update for dict.popitem(). (GH-8292)
files:
M Doc/library/stdtypes.rst
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index c9e3a94786c2..66467ac40c77 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -4220,12 +4220,18 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
.. method:: popitem()
- Remove and return an arbitrary ``(key, value)`` pair from the dictionary.
+ Remove and return a ``(key, value)`` pair from the dictionary.
+ Pairs are returned in :abbr:`LIFO (last-in, first-out)` order.
:meth:`popitem` is useful to destructively iterate over a dictionary, as
often used in set algorithms. If the dictionary is empty, calling
:meth:`popitem` raises a :exc:`KeyError`.
+ .. versionchanged:: 3.7
+
+ LIFO order is now guaranteed. In prior versions, :meth:`popitem` would
+ return an arbitrary key/value pair.
+
.. method:: setdefault(key[, default])
If *key* is in the dictionary, return its value. If not, insert *key*
More information about the Python-checkins
mailing list