]> granicus.if.org Git - python/commitdiff
Improve tutorial suggestion for looping techniques
authorRaymond Hettinger <python@rcn.com>
Tue, 1 Sep 2015 09:20:44 +0000 (02:20 -0700)
committerRaymond Hettinger <python@rcn.com>
Tue, 1 Sep 2015 09:20:44 +0000 (02:20 -0700)
Doc/tutorial/datastructures.rst

index 89589bc02deb89405a3c9e5dfb2b522cd31a0fc5..48faa9cc436a36000380f94575ac1b9e3ac1b84b 100644 (file)
@@ -664,18 +664,18 @@ retrieved at the same time using the :meth:`iteritems` method. ::
    gallahad the pure
    robin the brave
 
-To change a sequence you are iterating over while inside the loop (for
-example to duplicate certain items), it is recommended that you first make
-a copy.  Looping over a sequence does not implicitly make a copy.  The slice
-notation makes this especially convenient::
-
-   >>> words = ['cat', 'window', 'defenestrate']
-   >>> for w in words[:]:  # Loop over a slice copy of the entire list.
-   ...     if len(w) > 6:
-   ...         words.insert(0, w)
+It is sometimes tempting to change a list while you are looping over it;
+however, it is often simpler and safer to create a new list instead. ::
+
+   >>> import math
+   >>> raw_data = [56.2, float('NaN'), 51.7, 55.3, 52.5, float('NaN'), 47.8]
+   >>> filtered_data = []
+   >>> for value in raw_data:
+   ...     if not math.isnan(value):
+   ...         filtered_data.append(value)
    ...
-   >>> words
-   ['defenestrate', 'cat', 'window', 'defenestrate']
+   >>> filtered_data
+   [56.2, 51.7, 55.3, 52.5, 47.8]
 
 
 .. _tut-conditions: