list.remove()

Метод remove() удаляет первое вхождение указанного значения из списка. Если значение не найдено, выбрасывается исключение ValueError. В отличие от pop(), который работает по индексу и возвращает значение, remove() работает по значению и возвращает None.

Сигнатура

list.remove(x)

Параметры

x — значение, которое нужно удалить. Сравнение производится через ==.

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

None. Список модифицируется на месте. Если значение не найдено — ValueError.

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

Пример 1. Удаление по значению.

colors = ["red", "green", "blue", "green"]
colors.remove("green")
print(colors)

['red', 'blue', 'green']

Пример 2. Удаляется только первое вхождение.

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

[1, 3, 2, 1, 2]

Пример 3. Обработка ValueError.

items = ["A", "B", "C"]
try:
    items.remove("Z")
except ValueError as e:
    print("Ошибка:", e)

Ошибка: list.remove(x): x not in list

Пример 4. Безопасное удаление через проверку.

data = [10, 20, 30]
target = 99
if target in data:
    data.remove(target)
print(data)

[10, 20, 30]

Пример 5. Удаление всех вхождений через цикл.

Опасно изменять список во время прямого прохода — используйте генератор списка:

readings = [21, 0, 22, 0, 23, 0, 24]
cleaned = [x for x in readings if x != 0]
print(cleaned)

[21, 22, 23, 24]

См. также

list.pop() — удаление по индексу с возвратом значения
list.clear() — удаление всех элементов
list.index() — поиск позиции элемента

Примечание

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

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