Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】__name__定数の使い方

__name__定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__name__定数は、現在のモジュールの名前を文字列として保持する定数です。Pythonにおいて、モジュールはファイル単位でコードをまとめるものであり、この__name__定数は、そのモジュール自身がどのように利用されているかを識別するために非常に重要な役割を果たします。

具体的には、モジュールがPythonインタープリタによってスクリプトとして直接実行された場合、__name__定数の値は自動的に"__main__"という文字列に設定されます。一方、そのモジュールが他のモジュールからimport文を使って読み込まれた場合、__name__定数の値は、そのモジュールのファイル名(.py拡張子を除く)になります。

この特性を利用して、Pythonプログラマーはif __name__ == "__main__":という条件文をよく使用します。このブロック内に記述されたコードは、そのモジュールが直接実行された場合にのみ実行され、他のモジュールにインポートされた場合には実行されません。これにより、モジュールの動作確認用のコードや、そのモジュールを単体で起動する際の初期処理などを、ライブラリとして他のプログラムから利用されるコードと明確に区別して記述することが可能になります。__name__定数は、モジュールの利用コンテキストを判別し、コードの再利用性と堅牢性を高めるための基本的な仕組みを提供します。

構文(syntax)

1if __name__ == "__main__":
2    # スクリプトが直接実行された場合にこのブロックが実行されます
3    print("スクリプトが直接実行されました")

引数(parameters)

引数なし

引数はありません

戻り値(return)

str

この特殊な属性は、実行中のモジュール名を文字列として返します。スクリプトが直接実行された場合は "main" を、モジュールとしてインポートされた場合はそのモジュール名(ファイル名から .py を除いたもの)を返します。

関連コンテンツ