[Python]関数の引数単体アスタリスク(*)は何？【func(arg, *, kw):】

Python専門オンライン学習サービス、PyQ(パイキュー) ≫でPythonを勉強しているのですが、こんな関数が出てきました。

Pythondef func(arg, *, kw1, kw2):
    print('arg =', arg)
    print('kw1 =', kw1)
    print('kw2 =', kw2)
    print()

初見で「(ﾟДﾟ)ﾊｧ?」となったのが、１行目のこの赤いやつです↓。

なんだよここにあるアスタリスクは...！？

*argsとか**kwargsとかともまた違う感じがする。

というわけで調べてみたら、「これって直感的にピンとこないやつだなぁ」という感想。

アスタリスク以降の引数を、キーワード引数で受け取ることを強制する

この↑funcを呼び出すとき、

1. func(1, 2, 3)　とするとエラーになる。
2. func(1, kw1=1, kw2=2)　とすると正常に動く。

正常に動作する例：

Pythondef func(arg, *, kw1, kw2):
    print('arg =', arg)
    print('kw1 =', kw1)
    print('kw2 =', kw2)
    print()

func(1, kw1=1, kw2=1)

# 出力
# arg = 1
# kw1 = 2
# kw2 = 3

上記７行目赤線で、２番目と３番目の実引数の書式が「引数名(キーワード)=値」になっています。

引数1番目の arg は、アスタリスクの前にあり位置引数のため「値」のみ渡しています。

エラーになる例

Pythondef func(arg, *, kw1, kw2):
    print('arg =', arg)
    print('kw1 =', kw1)
    print('kw2 =', kw2)
    print()

func(1, 1, kw2=1)

# 出力
# TypeError: func() takes 1 positional argument but 2 positional arguments
# (and 1 keyword-only argument) were given

今度は、７行目でfuncに渡す２番目の引数が「引数名(キーワード)=値」の型になっていないためエラーになってしまいます。

エラーメッセージを見ると「１つの位置引数(arg)のみをとるはずが、２つの位置引数が渡されました」と出ているのもこの「*」の特徴を表しています。

くどいですが、funcに渡すべき２番目の引数は、 def func(arg, ✳︎, kw1, kw2)  と「アスタリスクの後ろ」に定義しているため、

となります。

もちろん、

です。

アスタリスクを仮引数っぽく書いているのに、関数を呼ぶ時に実引数として何かをそのアスタリスクに向けて渡すわけではない点に注意！

公式ドキュメント(python.org)を探したんですが、見つからなかったのでクラスメソッドさんのブログでふむふむしました。

参考にした記事[python初心者向け]関数の引数のアスタリスク(*)の意味

アスタリスクによるキーワード引数強制に何のメリットがあるの？

引数の渡し間違えを絶対に防ぎたい時＝品質が重要なとき、らしいです。

まだ実際に使うような場面に遭遇したことがないから実感が湧きませんが、関数を呼び出すときに定義元をよく確認しないと呼び出せないので「位置引数の渡す順番を間違えた」というミスを減らす効果はありそう。

おわりですm(_ _)m