snippetpythonTip

Watch out for mutable default arguments in Python

Submitted by: @import:30-seconds-of-code·Mar 2, 2026·

Viewed 0 times

outdefaultargumentswatchpythonmutablefor

Problem

Default arguments in Python are evaluated only once. The evaluation happens when the function is defined, instead of every time the function is called. This can inadvertently create hidden shared state, if you use a mutable default argument and mutate it at some point. This means that the mutated argument is now the default for all future calls to the function as well.
Take the following code as an example. Every call to the function shares the same list. So, the second time it's called, the function doesn't start out with an empty list. Instead, the default argument is the list containing the value from the previous call.
If you absolutely need to use a mutable object as the default value in a function, you can set the default value of the argument to None instead. Then, checking in the function body if it is None, you can set it to the mutable value you want without side effects.

Solution

def append(n, l = []):
  l.append(n)
  return l

append(0) # [0]
append(1) # [0, 1]

If you absolutely need to use a mutable object as the default value in a function, you can set the default value of the argument to None instead. Then, checking in the function body if it is None, you can set it to the mutable value you want without side effects.

Code Snippets

def append(n, l = []):
  l.append(n)
  return l

append(0) # [0]
append(1) # [0, 1]

def append(n, l = None):
  if l is None:
    l = []
  l.append(n)
  return l

append(0) # [0]
append(1) # [1]

Context

From 30-seconds-of-code: mutable-default-arguments

Revisions (0)

No revisions yet.