list.extend()

Метод extend() расширяет список, добавляя в его конец все элементы переданного итерируемого объекта (другого списка, кортежа, множества, строки, генератора и т.п.). В отличие от append(), который кладёт аргумент целиком как один элемент, extend() распаковывает аргумент.

Сигнатура

list.extend(iterable)

Параметры

iterable — любой итерируемый объект, элементы которого будут добавлены в список.

Возвращаемое значение

None. Список модифицируется на месте.

Примеры использования

Пример 1. Объединение двух списков.

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

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

Пример 2. extend() vs append().

x = [1, 2, 3]
x.append([4, 5])
print("append:", x)

y = [1, 2, 3]
y.extend([4, 5])
print("extend:", y)

append: [1, 2, 3, [4, 5]]
extend: [1, 2, 3, 4, 5]

Пример 3. Добавление элементов кортежа и множества.

data = [10]
data.extend((20, 30))
data.extend({40, 50})
print(data)

[10, 20, 30, 40, 50]

Пример 4. Расширение строкой — посимвольно.

Строка тоже итерируемый объект, и extend() добавит её посимвольно:

chars = ["A", "B"]
chars.extend("CDE")
print(chars)

['A', 'B', 'C', 'D', 'E']

Пример 5. Эквивалент через оператор +=.

Для списков += ведёт себя как extend():

readings = [21.0, 22.5]
new_batch = (23.1, 22.8, 21.9)
readings += new_batch
print(readings)

[21.0, 22.5, 23.1, 22.8, 21.9]

См. также

list.append() — добавление одного элемента
list.insert() — вставка по индексу
list.copy() — копирование списка

Примечание

Лицензия и источники

Техническое описание метода адаптировано из официальной документации Python (https://docs.python.org), доступной под Python Software Foundation License Version 2. Перевод на русский, примеры использования и пояснения — © AlashEd Wiki.