round()

转载须注明出处：简书@Orca_J35 | GitHub@orca-j35，所有笔记均托管于 python_notes 仓库

🔨 round(number[, ndigits])

该函数用于对 number 进行舍入，ndigits 用于设置精度。

ndigits 可以是任意整数值(正数、0、负数均可)。当 ndigits 被省略(或值为 None)时，将返回距 number 最近的整数；当传入 ndigits 参数时，将返回与 number 同类型的值。

# 注意观察返回值类型的类型
round(1.4), round(1.5) #> (1, 2)
round(1.4,0), round(1.5,0) #> (1.0, 2.0)

对于支持 round() 的内置类型，舍入结果是距离 number 最近的某个 的倍数。

# 当ndigits=1时，舍入结果应是pow(10,-1)=0.1的倍数，且是最接近number的某个0.1的倍数
round(0.24,1), round(-0.24,1)
#> (0.2, -0.2)

# 如果ndigits<1，便可对整数部分进行舍入
round(1024.61,-1),round(1024.61,-4),round(1024.61,-10)
#> (1020.0, 0.0, 0.0)
round(1024,-1),round(1024,-4),round(1024,-6)
#> (1020, 0, 0)

如果存在两个与 number 距离相等的 的倍数，则会向偶数方向进行舍入。

# 当ndigits=0时，舍入结果应是pow(10,0)的倍数，且是最接近number的的某个1的倍数
# 与0.5的距离相等的数有0和1，此时向偶数方向舍入，结果为0
# 与0.5的距离相等的数有0和-1，此时向偶数方向舍入，结果为0
round(0.5,0), round(-0.5,0) #> (0.0, -0.0)
# 与1.5的距离相等的数有1和2，此时向偶数方向舍入，结果为2
# 与-1.5的距离相等的数有-1和-2，此时向偶数方向舍入，结果为-2
round(1.5,0), round(-1.5,0) #> (2.0, -2.0)
# 与2.5的距离相等的数有2和3，此时向偶数方向舍入，结果为2
# 与-2.5的距离相等的数有-2和-3，此时向偶数方向舍入，结果为-2
round(2.5,0), round(-2.5,0) #> (2.0, -2.0)

在进行舍入时，还应考虑到浮点运算存在的限制：十进制数的小数部分大多不能使用浮点数精确表示(可阅读 Floating Point Arithmetic: Issues and Limitations)。比如在下面这个示例中，实际上浮点数 2.675 离 2.67 更近，因此舍入结果是 2.67 而不是我们预期中的 2.68。

# 当ndigits=2时，舍入结果应是pow(10,-2)的倍数，且是最接近number的某个0.01的倍数
# 但浮点数并不能准确表示十进制小数，实际上2.675更接近2.67
format(2.675,'.20'),round(2.675, 2)
#> ('2.6749999999999998224', 2.67)

# 当ndigits=1时，舍入结果应是pow(10,-1)的倍数，且是最接近number的某个0.1的倍数
# 但浮点数并不能准确表示十进制小数，实际上0.15更接近0.1，-0.15更接近-0.1
format(0.15,'.20'),round(0.15,1), round(-0.15,1)
#> ('0.14999999999999999445', 0.1, -0.1)
# 同理，浮点数并不能准确表示十进制小数，实际上0.35更接近0.3，-0.35更接近-0.3
format(0.35,'.20'),round(0.35,1), round(-0.35,1)
#> ('0.3499999999999999778', 0.3, -0.3)

# 0.25可被精确表示，0.25与0.2和0.3距离相等，此时向偶数方向舍入，结果为0.2
# -0.25可被精确表示，-0.25与-0.2和0-.3距离相等，此时向偶数方向舍入，结果为-0.2
format(0.25,'.20'),round(0.25,1), round(-0.25,1)
#> ('0.25', 0.2, -0.2)

参考：python中关于round函数的小坑

__round__

对于一般的 Python number 对象，round 函数会委托 number.__round__ 完成舍入：

class Foo:
    def __round__(self):
        return 61
round(Foo()) #> 61

还可阅读 object.__round__(self[, ndigits])

Py2 vs. Py3

返回值的类型

在 Py2 中，如果省略 ndigits 参数，则会默认 ndigits=0。无论是否传入 ndigits，结果始终是浮点数。

# in Py2
round(1.4), round(10,2)
#> (1.0, 10.0)

在 Py3 中，如果省略 ndigits 参数，则会返回距 number 最近的整数；如果传入 ndigits 参数，则返回与 number 同类型的值。

# in Py3
round(1.4), round(1.4,0), round(10,2)
#> (1, 1.0, 10)

舍入方向

在 Py2 中，如果存在两个与 number 距离相等的 的倍数，则会向远离 0 的方向进行舍入。

round(0.5,0), round(-0.5,0) #> (1.0, -1.0)
round(1.5,0), round(-1.5,0) #> (2.0, -2.0)
round(2.5,0), round(-2.5,0) #> (3.0, -3.0)

在 Py3 中，如果存在两个与 number 距离相等的 的倍数，则会向偶数方向进行舍入。

round(0.5,0), round(-0.5,0) #> (0.0, -0.0)
round(1.5,0), round(-1.5,0) #> (2.0, -2.0)
round(2.5,0), round(-2.5,0) #> (2.0, -2.0)