note how using iter* are unsafe while mutating and document iter(dict)

This commit is contained in:
Benjamin Peterson 2009-04-04 23:46:34 +00:00
parent 91a1a071a0
commit f9c8193b76
1 changed files with 14 additions and 0 deletions

View File

@ -1928,6 +1928,11 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
.. versionadded:: 2.2
.. describe:: iter(d)
Return an iterator over the keys of the dictionary. This is a shortcut
for :meth:`iterkeys`.
.. method:: clear()
Remove all items from the dictionary.
@ -1980,6 +1985,9 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
Return an iterator over the dictionary's ``(key, value)`` pairs. See the
note for :meth:`dict.items`.
Using :meth:`iteritems` while adding or deleting entries in the dictionary
will raise a :exc:`RuntimeError`.
.. versionadded:: 2.2
.. method:: iterkeys()
@ -1987,6 +1995,9 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
Return an iterator over the dictionary's keys. See the note for
:meth:`dict.items`.
Using :meth:`iterkeys` while adding or deleting entries in the dictionary
will raise a :exc:`RuntimeError`.
.. versionadded:: 2.2
.. method:: itervalues()
@ -1994,6 +2005,9 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
Return an iterator over the dictionary's values. See the note for
:meth:`dict.items`.
Using :meth:`itervalues` while adding or deleting entries in the
dictionary will raise a :exc:`RuntimeError`.
.. versionadded:: 2.2
.. method:: keys()