bpo-41774: Add programming FAQ entry (GH-22402)

In the "Sequences (Tuples/Lists)" section, add
"How do you remove multiple items from a list".

1 files changed, 15 insertions, 0 deletions

diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst
index 4f4ea8b..76ae4d2 100644
--- a/Doc/faq/programming.rst
+++ b/Doc/faq/programming.rst
@@ -1164,6 +1164,21 @@ This converts the list into a set, thereby removing duplicates, and then back
 into a list.
 
 
+How do you remove multiple items from a list
+--------------------------------------------
+
+As with removing duplicates, explicitly iterating in reverse with a
+delete condition is one possibility.  However, it is easier and faster
+to use slice replacement with an implicit or explicit forward iteration.
+Here are three variations.::
+
+   mylist[:] = filter(keep_function, mylist)
+   mylist[:] = (x for x in mylist if keep_condition)
+   mylist[:] = [x for x in mylist if keep_condition]
+
+If space is not an issue, the list comprehension may be fastest.
+
+
 How do you make an array in Python?
 -----------------------------------