From: Benjamin Peterson Date: Sat, 4 Apr 2009 23:46:34 +0000 (+0000) Subject: note how using iter* are unsafe while mutating and document iter(dict) X-Git-Tag: v2.7a1~1574 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=f9c8193b76beaf2585c2747d0645faf86e237d64;p=python note how using iter* are unsafe while mutating and document iter(dict) --- diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index af84f4f0d7..ae3856ce8e 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -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()