Pythonの関数にキーワード引数（**kwargs）を渡す方法をわかりやすく解説

Pythonでは、**kwargs（ダブルアスタリスク形式）を使うことで、関数に「キーワード付きの可変長引数」を辞書（dict）として渡すことができます。ここで重要なのは2つのアスタリスク（**）であり、kwargsという名前と組み合わせることで、「可変長のキーワード引数が辞書としてまとめられる」ことを示しています。

*argsと**kwargsの違い

*argsが任意の個数の位置引数をタプルとして受け取るのに対し、**kwargsは任意の個数のキーワード引数を受け取り、それらを辞書として扱います。つまり、**kwargsを使う場合は、呼び出し側で各引数にキーワード（名前）を割り当てる必要がある点が大きな違いです。

サンプルコード

def print_kwargs(**kwargs):
    print(kwargs)

print_kwargs(kwargs_1="Whale", kwargs_2=5, kwargs_3=False, kwargs_4=2.1)

実行結果

{'kwargs_4': 2.1, 'kwargs_1': 'Whale', 'kwargs_2': 5, 'kwargs_3': False}

このように、関数に渡されたキーワード引数は「キー＝引数名、値＝引数の値」というペアの辞書として関数内で受け取られます。なお、辞書の要素の順序は実行環境やバージョンによって表示順が異なる場合があります。

活用のポイント

**kwargsは、設定オプションを柔軟に受け渡したい場合や、ラッパー関数・デコレータを作成する際などによく使われます。*argsと組み合わせれば、位置引数とキーワード引数の両方を柔軟に処理できる汎用的な関数を定義することも可能です。