locals() ローカル名前空間
最終更新:2026-09-22
locals() ローカル名前空間
locals() は現在のスコープのローカル名前空間の辞書を返す。
| カテゴリ | 組み込み関数 |
|---|---|
| 種類 | 組み込み関数 |
| Python バージョン | all |
📝 構文
locals()
戻り値:Returns the local namespace dict of the current scope.
▶ 例
下のコードを編集し「実行」をクリックすると、出力パネルに結果が表示されます:
実行結果:
['a']
🏷️ 関連する組み込み関数
💡 関連するケース
さらに多くのケースは近日公開予定です。
❓ よくある質問
Q関数内で locals() は何を返しますか?
A現在の関数スコープのローカル変数の辞書を返します。定義されているすべてのローカル変数(引数を含む)を含みます。
Qモジュールのトップレベルで locals() と globals() は同じですか?
A同じです。トップレベルでは「ローカル=グローバル」なので、両者は同じ辞書を返します。
Qlocals()['x'] = 1 でローカル変数を変更できますか?
A関数内で返された辞書を変更しても、通常は実際のローカル変数は変わりません(CPython では関数内の locals() はスナップショットを返す)。この方法に依存しないでください。
Qlocals() は何に役立ちますか?
Aデバッグ時に現在のスコープのすべての変数を素早く確認したり、eval/exec にローカル名前空間を渡して実行環境を制御するのに使います。