python関数アノテーション(型ヒント)

関数アノテーションとは

関数アノテーション（関数の型ヒント） は、Python の関数に「引数や戻り値の型をコメント的に書ける仕組み」。

基本の書き方

def 関数名(引数名: 型, 引数名2: 型 = デフォルト値) -> 戻り値の型:
    処理

例

def add(x:int,y:int) -> int:
    return x + y

👉 この関数は「整数 x と y を受け取り、整数を返す」ことを表す。

関数アノテーションのメリット

・コードの可読性が上がる
→ 他人が見ても「どんな型を期待してるのか」分かりやすい
・IDEの補完が効きやすくなる
→ VSCode / PyCharm で型補完が出やすい
・静的解析ツールでミスを事前検出
→ 実行前に「型が違う」と警告が出せる