当前位置：首页 > Python > 正文

深入理解 Python 的 rfloordiv 方法（掌握反向整除运算的魔术方法）

主机测评网
Python
2025-12-14
177

在 Python 中，__rfloordiv__ 是一个特殊的“魔术方法”（Magic Method），用于实现反向整除运算。如果你正在学习 Python __rfloordiv__ 方法 或想了解如何自定义类的整除行为，那么本文将带你从零开始，一步步掌握这个强大而实用的功能。

什么是 floordiv 和 rfloordiv？

在 Python 中，// 运算符用于执行向下取整除法（也叫地板除）。例如：

7 // 3  # 结果是 2

当你对两个对象使用 // 时，Python 会首先尝试调用左边对象的 __floordiv__ 方法。如果左边对象没有实现该方法，或者返回了 NotImplemented，Python 就会尝试调用右边对象的 __rfloordiv__ 方法。

简单来说：
- a // b → 调用 a.__floordiv__(b)
- 如果失败 → 调用 b.__rfloordiv__(a)

深入理解 Python 的 __rfloordiv__ 方法（掌握反向整除运算的魔术方法）方法反向整除运算魔术方法自定义类整除行为第1张

为什么需要 rfloordiv？

假设你创建了一个自定义类（比如表示货币或分数），并希望它能与内置类型（如 int 或 float）进行整除运算。但内置类型并不知道你的类的存在，因此无法处理 5 // MyNumber(10) 这样的表达式。

这时，__rfloordiv__ 就派上用场了！它允许你的类“接管”当它位于运算符右侧时的整除逻辑。

实战：编写一个支持整除的自定义类

下面是一个简单的 Number 类，它实现了 __floordiv__ 和 __rfloordiv__ 方法：

class Number:    def __init__(self, value):        self.value = value    def __floordiv__(self, other):        if isinstance(other, Number):            return Number(self.value // other.value)        elif isinstance(other, (int, float)):            return Number(self.value // other)        return NotImplemented    def __rfloordiv__(self, other):        # 当 Number 实例在 // 右侧时被调用        if isinstance(other, (int, float)):            return Number(other // self.value)        return NotImplemented    def __repr__(self):        return f"Number({self.value})"

现在我们来测试一下：

a = Number(10)print(a // 3)      # 调用 a.__floordiv__(3) → Number(3)print(20 // a)     # 调用 a.__rfloordiv__(20) → Number(2)

如果没有 __rfloordiv__，第二行代码 20 // a 会抛出 TypeError，因为整数 20 不知道如何与 Number 对象做整除。

常见误区与注意事项

不要混淆 __floordiv__ 和 __truediv__：前者对应 //（整除），后者对应 /（真除）。
返回 NotImplemented 而不是抛异常：如果方法无法处理传入的类型，应返回 NotImplemented，让 Python 尝试其他方法（如 __rfloordiv__）。
保持对称性：理想情况下，a // b 和 b // a 应有合理的逻辑，避免让用户困惑。