Методы списков:
добавление и удаление

Категория

Методы list

Уровень

Начальный

Связанные темы

Списки, индексы, for

Зачем это знать

Управлять содержимым списка

§1Что такое метод

Метод — действие, принадлежащее объекту. Сначала пишется список, затем точка и вызов метода: список.метод(аргументы).

numbers.append(4)
│       │      └ аргумент
│       └ метод списка
└ список

Отличие метода от функции — в форме записи. len(numbers) — функция, список передан ей аргументом. numbers.append(4) — метод, он вызван у самого списка и работает именно с ним.

§2append(): один элемент

append(value) добавляет один объект в конец списка.

numbers = [1, 2, 3]
numbers.append(4)
print(numbers)

[1, 2, 3, 4]

Слово «один» здесь ключевое. Аргумент может быть списком, строкой, словарём или другим объектом — но добавляется он целиком, как единственный новый элемент.

data = [1, 2]
data.append([10, 20])
print(data)
print(len(data))

[1, 2, [10, 20]]
3

Список [10, 20] занял ровно одну позицию — с индексом 2. Чтобы вместо этого добавить два отдельных числа, нужен extend().

§3append() и результат None

append() меняет существующий список и не создаёт новый. Возвращать ему нечего, поэтому результат вызова равен None.

numbers = [1, 2]
result = numbers.append(3)

print(numbers)
print(result)

[1, 2, 3]
None

§4Накопление списка в цикле

Самый частый сценарий с append() — постепенно собрать результат. Список создают пустым, а цикл наполняет его по одному элементу.

squares = []

for number in range(1, 6):
    squares.append(number * number)

print(squares)

[1, 4, 9, 16, 25]

Строка squares = [] обязательно стоит до цикла. Внутри цикла она обнуляла бы список на каждом повторе, и в результате остался бы один последний элемент.

§5extend(): несколько элементов

extend(iterable) перебирает переданный объект и добавляет каждый его элемент отдельно.

numbers = [1, 2, 3]
numbers.extend([4, 5, 6])
print(numbers)

[1, 2, 3, 4, 5, 6]

Аргумент должен быть итерируемым — таким, который можно перебрать циклом. Строка этому условию удовлетворяет, и потому разбирается на отдельные символы.

letters = ["a"]
letters.extend("bc")
print(letters)

['a', 'b', 'c']

Число итерируемым не является: numbers.extend(5) вызовет TypeError. Для одного значения нужен append().

§6append() или extend()

Это самая частая развилка в теме. Разница в одном: append() кладёт аргумент целиком, extend() сначала его разбирает.

append([3, 4]) → [1, 2, [3, 4]]   длина 3
extend([3, 4]) → [1, 2,  3,  4 ]   длина 4

Практическое правило: добавляете одно значение — append(); присоединяете содержимое другой коллекции — extend().

§7insert(): вставка по индексу

insert(index, value) вставляет один элемент перед указанной позицией. Всё, что стояло правее, сдвигается на одну позицию.

numbers = [1, 2, 3]
numbers.insert(1, 100)
print(numbers)

[1, 100, 2, 3]

было:  индекс 0 → 1,  индекс 1 → 2,  индекс 2 → 3
стало: индекс 0 → 1,  индекс 1 → 100, индекс 2 → 2, индекс 3 → 3

Две последние строки часто удивляют. insert() в отличие от индексного доступа не выдаёт IndexError: выходящий за границы индекс он просто прижимает к краю. А insert(-1, value) вставляет перед последним элементом — чтобы добавить в конец, нужен append().

§8remove(): удаление значения

remove(value) ищет значение слева направо и удаляет только первое совпадение.

numbers = [1, 2, 3, 2]
numbers.remove(2)
print(numbers)

[1, 3, 2]

Важно различать два способа удаления: remove() работает по значению, а pop() и del — по индексу. Они разбираются в главе 3.11.

Если значения в списке нет, возникает ValueError и программа останавливается. Когда отсутствие допустимо, перед удалением ставят проверку in.

numbers = [1, 2, 3]
value = 10

if value in numbers:
    numbers.remove(value)

print(numbers)

[1, 2, 3]

§9Изменение на месте

Все четыре метода объединяет одно свойство: они меняют существующий список и возвращают None. Новый объект при этом не создаётся.

Пока список известен под одним именем, эта деталь незаметна. Она становится важной, как только имён становится два.

§10Два имени — один список

Присваивание backup = tasks не копирует список. Оно даёт тому же самому списку второе имя.

tasks  ─┐
        ├─→ ["хлеб"]
backup ─┘

tasks = ["хлеб"]
backup = tasks

tasks.append("врач")

print(tasks)
print(backup)

['хлеб', 'врач']
['хлеб', 'врач']

Никакой копии не было. append() изменил единственный существующий список, и оба имени показывают на него же — поэтому «резервная копия» изменилась вместе с оригиналом.

§11Как получить независимый список

Если нужен именно отдельный список, его создают явно — методом copy().

tasks = ["хлеб"]
backup = tasks.copy()

tasks.append("врач")

print(tasks)
print(backup)

['хлеб', 'врач']
['хлеб']

У копирования есть тонкость с вложенными списками — она разбирается в главе 3.12 вместе с deepcopy().

§12Метод или новый список

Тот же результат иногда можно получить операцией +. Разница в том, что она не трогает исходный список, а строит новый.

a = [1, 2]
b = a + [3]

print(a)
print(b)

[1, 2]
[1, 2, 3]

В цикле предпочтительнее append(): запись result = result + [value] создаёт новый список на каждом повторе и потому работает заметно медленнее.

§13Все четыре метода вместе

Небольшой сквозной пример — список покупок, который меняется по ходу программы.

cart = ["хлеб", "молоко"]

cart.append("яйца")
cart.insert(0, "вода")
cart.extend(["сыр", "чай"])
cart.remove("молоко")

print(cart)
print(len(cart))

['вода', 'хлеб', 'яйца', 'сыр', 'чай']
5

Всё это время cart — один и тот же список: он не пересоздавался ни разу, менялось только его содержимое.

§14Частые ошибки

§15Проверьте себя

§16Шпаргалка

Итог главы

append() добавляет один объект, extend() — элементы итерируемого объекта, insert() вставляет по индексу, а remove() удаляет первое совпавшее значение. Все четыре метода изменяют список на месте и возвращают None, поэтому их результат не присваивают обратно. И поэтому же присваивание backup = items копией не является: для независимого списка нужен copy().