【Python入門】関数にデフォルト引数を設定する方法と落とし穴の回避策

Pythonにおけるデフォルト引数（デフォルトパラメータ値）の扱いは、多くの初心者がつまずきやすいポイントの一つです。

問題となるのは「ミュータブル」なデフォルト値

トラブルの原因になるのは、ミュータブル（可変）なオブジェクトをデフォルト値として指定するケースです。ミュータブルとは、リストや辞書のように、生成後に中身をその場で変更できるオブジェクトのことを指します。

たとえば、第2引数が省略された場合に「呼び出すたびに新しいリストが作られる」と期待してコードを書くと、本来は次のような出力を想定しているはずです。

[12]
[43]

実際に起こること

しかし実際のPythonでは、リストは関数が定義された時点で一度だけ作成され、以降の呼び出しでは毎回同じリストが使い回されます。

これは、Pythonのデフォルト引数が「関数を呼び出すたび」ではなく「関数を定義したときに一度だけ」評価されるためです。そのため、ミュータブルなデフォルト引数の中身を変更すると、その変更は以降のすべての関数呼び出しにも影響してしまいます。

正しい対処法

推奨される解決策は、デフォルト値として None を指定し、「引数が渡されなかった場合だけ」関数内で新しいオブジェクトを作成する方法です。None はイミュータブルなので安全であり、この用途で広く使われています。

悪い例

def func(data=[]):
    data.append(1)
    return data

func()
func()  # 前回の呼び出し結果が残ってしまう

良い例

def append2(element, foo=None):
    if foo is None:
        foo = []  # 呼び出しごとに新しいリストを作成
    foo.append(element)
    return foo

print(append2(12))
print(append2(43))

実行結果

[12]
[43]

このように None を番兵（センチネル）として使うことで、毎回独立した新しいリストが生成され、意図どおりの動作になります。辞書やセットなど、他のミュータブルなオブジェクトをデフォルト値にしたい場合も同様の手法が有効です。