[Python-checkins] cpython (2.7): Issue #25286: Dictionary views are not sequences
martin.panter
python-checkins at python.org
Wed Oct 7 06:23:58 EDT 2015
https://hg.python.org/cpython/rev/41e1f2500047
changeset: 98585:41e1f2500047
branch: 2.7
parent: 98578:37aee118e1a3
user: Martin Panter <vadmium+py at gmail.com>
date: Wed Oct 07 10:19:39 2015 +0000
summary:
Issue #25286: Dictionary views are not sequences
Also change glossary heading from "view" to "dictionary view". Patch by Akira
Li.
files:
Doc/glossary.rst | 15 ++++++++-------
Doc/library/collections.rst | 2 +-
2 files changed, 9 insertions(+), 8 deletions(-)
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -182,6 +182,14 @@
keys can be any object with :meth:`__hash__` and :meth:`__eq__` methods.
Called a hash in Perl.
+ dictionary view
+ The objects returned from :meth:`dict.viewkeys`, :meth:`dict.viewvalues`,
+ and :meth:`dict.viewitems` are called dictionary views. They provide a dynamic
+ view on the dictionary’s entries, which means that when the dictionary
+ changes, the view reflects these changes. To force
+ dictionary view to become a full list use ``list(dictview)``. See
+ :ref:`dict-views`.
+
docstring
A string literal which appears as the first expression in a class,
function or module. While ignored when the suite is executed, it is
@@ -713,13 +721,6 @@
``'\r'``. See :pep:`278` and :pep:`3116`, as well as
:func:`str.splitlines` for an additional use.
- view
- The objects returned from :meth:`dict.viewkeys`, :meth:`dict.viewvalues`,
- and :meth:`dict.viewitems` are called dictionary views. They are lazy
- sequences that will see changes in the underlying dictionary. To force
- the dictionary view to become a full list use ``list(dictview)``. See
- :ref:`dict-views`.
-
virtual environment
A cooperatively isolated runtime environment that allows Python users
and applications to install and upgrade Python distribution packages
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -978,7 +978,7 @@
KeysView
ValuesView
- ABCs for mapping, items, keys, and values :term:`views <view>`.
+ ABCs for mapping, items, keys, and values :term:`views <dictionary view>`.
These ABCs allow us to ask classes or instances if they provide
--
Repository URL: https://hg.python.org/cpython
More information about the Python-checkins
mailing list