返回专栏
专栏 ·

5.3 魔术方法(Dunder Methods):让自定义对象支持运算符重载、迭代与切片协议

作者: 九路 共 12 章 · 48 小节

欢迎回到 HelloWorld 技术社区(www.helloworld.net) 《Python 现代开发实战》专栏。

为什么 Python 的内置类型用起来如此一致——无论是字符串、列表还是字典,都能用 len(x) 算长度、用 for item in x 遍历、用 x[0] 索引、用 + 合并?

因为 Python 底层建立了一套名为 Python 数据模型(Data Model) 的协议体系:只要你的自定义类实现了对应的双下划线魔术方法(Dunder Methods),它就能享受与内置类型同等的“一等公民”语法待遇。

from collections.abc import Iterator


class Playlist:
    """支持 len()、索引切片、成员判断(in)、遍历及 + 合并的自定义播放列表"""

    def __init__(self, name: str, tracks: list[str]) -> None:
        self.name = name
        self._tracks = list(tracks)

    def __repr__(self) -> str:
        # 面向开发者与调试器的精确表达(原则:尽量能通过 eval 还原)
        return f"Playlist(name={self.name!r}, tracks={self._tracks!r})"

    def __str__(self) -> str:
        # 面向终端用户的友好展示
        return f"歌单《{self.name}》(共 {len(self)} 首)"

    def __len__(self) -> int:
        return len(self._tracks)

    def __getitem__(self, index: int | slice) -> str | list[str]:
        return self._tracks[index]

    def __iter__(self) -> Iterator[str]:
        return iter(self._tracks)

    def __add__(self, other: "Playlist") -> "Playlist":
        if not isinstance(other, Playlist):
            return NotImplemented
        return Playlist(f"{self.name}+{other.name}", self._tracks + other._tracks)


p1 = Playlist("编码专享", ["Lofi Beat", "Rain Sound"])
p2 = Playlist("深夜冲刺", ["Synthwave"])
merged = p1 + p2
print(str(merged), "| 第一首:", merged[0], "| 包含 Rain:", "Rain Sound" in merged)

💬 HelloWorld 社区实战打卡

请为自定义的 Vector2D(x, y) 二维向量类实现 __add__(向量相加)和 __eq__(坐标相等判断)魔术方法,带 #Python专栏打卡 贴出代码!