list.remove() Remove first match
Last updated: 2026-09-22
list.remove() Remove first match
list.remove(x) removes the first occurrence of x; raises ValueError if missing.
| Category | List Methods |
|---|---|
| Kind | Built-in Type Method |
| Python Version | all |
📝 Syntax
list.remove(x)⚙️ Parameters
| x Required | The value to remove; only the first match is deleted. |
|---|
Returns：None (removes the first occurrence of x in place).
Mutates the original：Yes (in place)
💥 Raises
ValueError— Raised when x is not in the list.
▶ Example
Edit the code, press Run, and see the result in the output panel:
Output：
[1, 3, 2]💡 Related Cases
More case studies coming soon — check back later.
❓ FAQ
QHow many matches does remove() delete?
AOnly the first match. After lst = [1, 2, 3, 2] and lst.remove(2), the list becomes [1, 3, 2].
QWhat happens when the element does not exist?
AA ValueError: list.remove(x): x not in list is raised. When unsure, check with in first or use try/except.
QWhat does remove() return?
ANone. To obtain the removed element, use pop().
QWhat is the difference between remove() and del?
Aremove() deletes by value; del lst[i] deletes by index.
