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

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

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

作成日: 更新日:

基本的な使い方

__name__定数は、Pythonプログラムにおいて、現在のモジュールがどのように利用されているかを示す文字列を保持する定数です。この定数の主な役割は、モジュールが直接実行されているのか、それとも他のモジュールからインポートされて利用されているのかを識別することにあります。

具体的には、Pythonファイルをコマンドラインなどから直接実行した場合、そのファイル内の__name__変数の値は、特別な文字列である"__main__"となります。これは、そのファイルが「メインのプログラム」として実行されていることを意味します。

一方で、そのファイルを別のPythonファイルからimport文を使ってモジュールとして読み込んだ場合、__name__変数の値は、そのモジュールの実際の名前(通常はファイル名から拡張子を除いたもの)に設定されます。

この特性を活用することで、開発者はPythonスクリプト内で「if __name__ == "__main__":」という条件文を使って、あるコードブロックが直接実行された場合にのみ特定の処理(例えば、テストコードの実行やアプリケーションの起動処理など)を行うように制御できます。これにより、一つのファイルをスタンドアロンのアプリケーションとしても、他のプログラムから利用されるモジュールとしても、柔軟に設計できます。これはPythonでモジュールを扱う上で非常に一般的な慣用句であり、コードの再利用性を高める上で重要な概念です。

構文(syntax)

1if __name__ == "__main__":
2    print("このスクリプトは直接実行されました。")
3else:
4    print("このスクリプトはモジュールとしてインポートされました。")

引数(parameters)

引数なし

引数はありません

戻り値(return)

str

__name__ は、そのオブジェクトの名前を表す文字列を返します。モジュールやクラス、関数などの定義時に自動的に付与される名前です。

関連コンテンツ