Python append: добавляем элемент в конец списка

Первый список из прошлого урока был записан целиком, одной строкой. Реальные данные так не живут: товары попадают в корзину по одному, оценки — по мере сдачи работ, логи — по мере событий. Списку нужно уметь расти во время работы программы. Для этого у него есть метод append — самая частая операция над списками в настоящем коде. Разберём, как он работает, куда именно кладёт элемент и почему одна невинная строка с присваиванием ломает список.

Первый append: один элемент в конец

Метод вызывается через точку после имени списка: cart.append('сыр'). Элемент дописывается в самый конец, остальные не двигаются:

cart = ['хлеб', 'молоко']
cart.append('сыр')
print(cart)
print(len(cart))

['хлеб', 'молоко', 'сыр']
3

Два товара стали тремя: длина выросла ровно на единицу — append добавляет один элемент за вызов. Добавить два товара за раз через append нельзя: второй аргумент вызов просто не примет:

cart = ['хлеб']
cart.append('сыр', 'сок')

Traceback (most recent call last):
  File "app.py", line 2, in <module>
    cart.append('сыр', 'сок')
    ~~~~~~~~~~~^^^^^^^^^^^^^^
TypeError: list.append() takes exactly one argument (2 given)

Пачки добавляет extend — о нём следующий урок.

append меняет список на месте

append не строит новый список — он изменяет существующий. Это удобнее всего увидеть, напечатав результат самого вызова:

cart = ['хлеб']
print(cart.append('молоко'))
print(cart)

None
['хлеб', 'молоко']

Первая печать показала None — и это не поломка, а честный ответ метода. append возвращает None: вся его работа — изменить список, к которому его применили, поэтому отдавать результат он не может. Само изменение уже произошло, вторая печать это показывает: в cart теперь два товара. Новичок ожидает, что метод вернёт обновлённый список, и пишет присваивание — вот здесь список теряется:

cart = ['хлеб']
cart = cart.append('молоко')
try:
    cart.append('сыр')
except AttributeError as e:
    print('Ошибка:', e)

Ошибка: 'NoneType' object has no attribute 'append'

Строка cart = cart.append('молоко') записала в переменную None: добавление уже случилось, а присваивание затёрло список тем, что вернул метод, — ничем. Дальше по коду любая работа с cart падает, и сообщение всегда подозрительно упоминает NoneType. Без try/except та же история выглядит как обычный traceback:

cart = ['хлеб']
cart = cart.append('молоко')
print(len(cart))

Traceback (most recent call last):
  File "app.py", line 3, in <module>
    print(len(cart))
          ~~~^^^^^^
TypeError: object of type 'NoneType' has no len()

append кладёт ровно один элемент

Аргумент append становится одним элементом списка — каким бы значением он ни был. Передадим списком сразу два товара и посмотрим, что ляжет в корзину:

cart = ['хлеб']
cart.append(['яйца', 'майонез'])
print(cart)
print(len(cart))

['хлеб', ['яйца', 'майонез']]
2

Внутри корзины оказался не майонез и не яйца, а целый подсписок: длина выросла до двух, а не до трёх. append не разбирает аргумент на части — он кладёт его как единый элемент, и внутри корзины получился вложенный список. Такие списки-таблицы разбираются отдельно в уроке про список списков, а для добавления пачкой элементов нужен extend.

append в цикле: шаблон сборки результатов

Самый распространённый узор с append — сборка нового списка из цикла: заводят пустой список и на каждом шаге кладут в него очередной результат. Соберём цены со скидкой десять процентов:

prices = [199, 89, 449]
with_discount = []
for price in prices:
    with_discount.append(round(price * 0.9))
print(with_discount)
print(len(with_discount))

[179, 80, 404]
3

Исходный список prices не тронут — каждый шаг цикла положил результат в новый список with_discount. Пустой список плюс append в цикле — типовой шаблон сборки: начинаем с пустого списка и на каждом шаге кладём в него результат. Тот же шаблон собирает отбор: в новый список попадают только подходящие элементы,

nums = [3, 8, 5, 12, 7]
even = []
for n in nums:
    if n % 2 == 0:
        even.append(n)
print(even)
print(len(nums), len(even))

[8, 12]
5 2

Из пяти чисел в новый список легли два чётных: append сработал только там, где условие пропустило значение. Исходный список не изменился — 5 против 2 в печати длин. Шаблон встречается в каждом втором скрипте обработки данных; в уроке про генератор списков покажут, как записывать его одной строкой.

Способы пополнить список

append — не единственный способ добавить данные, и важно различать их по задаче:

Правило выбора простое: по одному значению — append, готовой коллекцией — extend, по номеру места — insert. Все три способа меняют список на месте и ничего не возвращают, поэтому присваивать их результат не нужно ни в каком случае.

append освоен: один элемент за вызов, в конец, на месте, без возврата. Остаётся второй способ пополнения — вставка по индексу и добавление пачкой: insert и extend из следующего урока закрывают обе задачи.