Python 特殊方法 round() 实现 round(obj)

说明

《Python 教程》持续更新中，提供建议、纠错、催更等加作者微信: gairuo123（备注：pandas教程）和关注公众号「盖若」ID: gairuo。跟作者学习，请进入 Python学习课程。欢迎关注作者出版的书籍：《深入浅出Pandas》和《Python之光》。

object.__round__(self[, ndigits]) 是 Python 中的一个特殊方法，用于自定义对象的四舍五入（准确说是舍入）行为。这个方法允许你定义对象在调用内置的 round() 函数时如何进行舍入。

self：表示对象本身。
ndigits：可选参数，表示要舍入到小数点后几位。如果省略此参数，则默认为 0。

示例

下面是一个简单的示例，说明了如何使用 __round__() 方法：

class MyNumber:
    def __init__(self, value):
        self.value = value
    
    def __round__(self, ndigits=None):
        if ndigits is None:
            return round(self.value)
        else:
            return round(self.value, ndigits)

num = MyNumber(3.14159)

# 调用内置的 round() 函数
print(round(num))       # 输出：3
print(round(num, 2))    # 输出：3.14

在这个示例中，MyNumber 类定义了 __round__() 方法，该方法接受一个可选的 ndigits 参数。当 round() 函数被调用时，Python 会自动调用 __round__() 方法来进行舍入操作，返回舍入后的值。

应用

要实现真正的四舍五入，可以使用 Python 标准库中的 Decimal 类来处理精确的十进制数值计算，并利用其内置的四舍五入功能。下面是一个示例：

from decimal import Decimal, ROUND_HALF_UP

class MyNumber:
    def __init__(self, value):
        self.value = Decimal(str(value))  # 将输入的值转换为 Decimal 对象
    
    def __round__(self, ndigits=None):
        if ndigits is None:
            return self.value.quantize(Decimal('1'), rounding=ROUND_HALF_UP)  # 默认情况下，四舍五入到整数
        else:
            return self.value.quantize(Decimal('1e-{0}'.format(ndigits)), rounding=ROUND_HALF_UP)  # 四舍五入到指定小数位数

# 示例用法
num = MyNumber(2.675)

# 保留两位小数的真正四舍五入
print(round(num, 2))  # 输出：2.68
# 默认的舍入
print(round(2.675, 2)) # 输出: 2.67

在这个示例中，MyNumber 类使用 Decimal 类来表示数字，以确保精确的十进制数值计算。在 __round__() 方法中，利用了 quantize() 方法来实现真正的四舍五入，使用了 ROUND_HALF_UP 舍入模式。这样可以确保四舍五入的精度并得到正确的结果。

参考

https://docs.python.org/zh-cn/3/reference/datamodel.html#object.__round__

< `__index__()` 对象的索引值 Python 的特殊方法 `__trunc__()` 实现 math.trunc(obj) >

更新时间：2024-03-05 17:34:42 标签：python 特殊方法数字

Python 特殊方法 __round__() 实现 round(obj)

示例

应用

参考

Python 特殊方法 round() 实现 round(obj)