【Python】アンダースコア解説 | マングリングと特殊変数を紹介！

【Python】アンダースコア解説 | マングリングと特殊変数を紹介！

当ページのリンクには広告が含まれています。

記事の文字数：2597

Pythonにはアンダースコア（_）を用いたさまざまな命名規則が存在し、特にクラスの属性名では「名前マングリング（Name Mangling）」という仕組みが適用されることがあります。本記事では、Pythonにおけるアンダースコアの使い方や__init__ や __str__ などの特殊変数・特殊メソッドの役割についても詳しく紹介します。


スポンサーリンク

Pythonの変数名や関数名にはアンダースコア（_）を使用することがあります。特に、クラスの属性名では、特別な意味を持つことがあり、カプセル化を目的とした「名前マングリング（Name Mangling）」という仕組みも存在します。本記事では、Pythonのアンダースコアの使い方と、名前マングリングの仕組みについて解説します。

マングリングは識別子の名前変更

マングリング（Mangling）とは、特定の識別子の名前を変更することで、意図しないアクセスや衝突を防ぐ技術のことです。Pythonでは、クラスの変数やメソッド名にダブルアンダースコア（__）を付けると、名前が自動的に変更され、外部から直接アクセスしにくくなります。

名前マングリングの主な目的は、

  • クラスの継承時に、親クラスの変数と子クラスの変数が意図せず衝突するのを防ぐ
  • クラスの内部変数を外部から直接操作されにくくする

といった点にあります。

アンダースコアの種類と意味

Pythonにおけるアンダースコアの使い方には、以下のようなパターンがあります。

前置シングルアンダースコア（_var）

変数名の前にアンダースコアを付けると、これは「非公開（private）」であることを示唆する慣習です。ただし、Pythonでは厳密なアクセス制御はないため、外部からアクセスは可能です。

class Example:
    def __init__(self):
        self._hidden = 42  # 内部的に使うべき変数（非公開の意図）


obj = Example()
print(obj._hidden)  # 42（アクセス可能）

前置ダブルアンダースコア（__var）

変数名の先頭にダブルアンダースコアを付けると、Pythonはその変数名を変更（マングリング）します。具体的には、クラス名を前置して変数名を変換することで、外部からのアクセスを困難にします。

class Example:
    def __init__(self):
        self.__private = 99  # マングリングされる


obj = Example()
print(obj.__private)  # AttributeError: 'Example' object has no attribute '__private'

実際には、変数名が _クラス名__変数名 に変換されているため、以下のようにアクセス可能です。

print(obj._Example__private)  # 99

後置シングルアンダースコア（var_）

Pythonの予約語（class, def, lambda など）と変数名が衝突するのを防ぐために、後置アンダースコアを使用することがあります。

def function(var, class_):  # `class` は予約語のため、`class_` を使用
    return var + class_

単独のアンダースコア（_）

  1. インタープリタ環境で直前の評価結果を保持する変数として使用されます。
  2. ループや関数で「無視する変数」として使用されることがあります。
for _ in range(3):
    print("Hello")  # 3回出力される

マングリングした変数の参照方法

名前マングリングは、クラスの継承時に意図しない変数の上書きを防ぐために利用されます。

class Parent:
    def __init__(self):
        self.__value = 10


class Child(Parent):
    def __init__(self):
        super().__init__()
        self.__value = 20  # Parent の __value とは異なる変数


c = Child()
print(c._Child__value)  # 20
print(c._Parent__value)  # 10

このように、__value はクラスごとに異なる名前へマングリングされるため、意図せず上書きされることを防げます。

名前マングリングの使用時の注意点

名前マングリングは便利ですが、いくつかの注意点があります。

  1. 完全なプライバシーを保証するものではない

    • obj._ClassName__variable のようにアクセスできるため、セキュリティ対策としては不十分です。

  2. デバッグやリファクタリング時の混乱を招く可能性がある

    • クラス名を含む形に変換されるため、手動でアクセスする際に変数名がわかりにくくなる。

  3. サブクラスで意図せず同じ名前を使うと、別の変数として扱われる

    • 継承時に、親クラスと子クラスで同じ変数名を使うと、それぞれ異なる変数として扱われる。

  4. 外部とのインターフェースを設計する際には慎重に

    • マングリングを利用して変数を「隠す」ことで、ライブラリ利用者が内部実装に依存しないようにできるが、適切にドキュメント化する必要がある。

特定の目的を持つ特殊変数・特殊メソッド

Pythonには、特定の目的を持つ特殊変数や特殊メソッドが存在し、それらは通常ダブルアンダースコア（__）で囲まれています。これらはPythonの内部的な動作をカスタマイズするために使用されます。

特殊メソッド__init__（コンストラクタ）

クラスのインスタンスが生成される際に自動的に呼び出される初期化メソッドです。

class Example:
    def __init__(self, value):
        self.value = value


obj = Example(10)
print(obj.value)  # 10

特殊メソッド__str__（文字列表現）

オブジェクトの文字列表現を定義し、print() などで表示される内容を指定できます。

class Example:
    def __init__(self, value):
        self.value = value


    def __str__(self):
        return f"Example with value: {self.value}"


obj = Example(42)
print(obj)  # Example with value: 42

特殊メソッド__repr__（デバッグ用の文字列表現）

オブジェクトの公式な文字列表現を定義し、repr() で取得できます。

class Example:
    def __init__(self, value):
        self.value = value


    def __repr__(self):
        return f"Example({self.value})"


obj = Example(42)
print(repr(obj))  # Example(42)

その他の特殊メソッド

  • __len__ : len(obj) の結果を定義
  • __getitem__ : obj[index] の動作を定義
  • __setitem__ : obj[index] = value の動作を定義
  • __delitem__ : del obj[index] の動作を定義
  • __call__ : obj() のようにインスタンスを関数として呼び出せるようにする

これらの特殊メソッドを適切に実装することで、オブジェクトの振る舞いを直感的に制御できます。

よく使われる特殊変数一覧

以下は、よく使われる特殊変数です。

変数名説明
__name__モジュールの名前。スクリプトとして実行されている場合は "__main__"。
__file__実行中のスクリプトのファイルパス。
__doc__モジュール、クラス、関数のドキュメンテーション文字列（docstring）。
__package__モジュールが属するパッケージ名。
__dict__オブジェクト（通常はクラスやインスタンス）の属性を保持する辞書。
__class__オブジェクトのクラス情報。

アンダースコアまとめ

Pythonのアンダースコアと名前マングリングは、コードの可読性や安全性を向上させるために重要な概念です。

  • _var は非公開の意図を示す（アクセスは可能）。
  • __var は名前マングリングにより、外部から直接アクセスしにくくなる。
  • __で囲う特殊変数・メソッドが存在する。
  • var_ は予約語との衝突を避ける。
  • _ は一時変数や直前の評価結果として使われる。
  • 名前マングリングは便利だが、完全なプライバシーを保証するものではなく、適切な設計と理解が必要。

適切にアンダースコアを活用し、より安全で可読性の高いPythonコードを書きましょう。

プログラミング学習者にお勧めの書籍

独学で身につけるためのプログラミング学習術: Ver.5

新品価格
￥980から
(2025/4/22 21:15時点)

以上で本記事の解説を終わります。
よいITライフを！
Scroll to Top