目录

一、概述

1、定义

2、作用

二、应用场景

1、构造和析构

2、操作符重载

3、字符串和表示

4、容器管理

5、可调用对象

6、上下文管理

7、属性访问和描述符

8、迭代器和生成器

9、数值类型

10、复制和序列化

11、自定义元类行为

12、自定义类行为

13、类型检查和转换

14、自定义异常

三、学习方法

1、理解基础

2、查阅文档

3、编写示例

4、实践应用

5、阅读他人代码

6、参加社区讨论

7、持续学习

8、练习与总结

9、注意兼容性

10、避免过度使用

四、魔法方法

17、__float__方法

17-1、语法

17-2、参数

17-3、功能

17-4、返回值

17-5、说明

17-6、用法

18、__floor__方法

18-1、语法

18-2、参数

18-3、功能

18-4、返回值

18-5、说明

18-6、用法

19、__floordiv__方法

19-1、语法

19-2、参数

19-3、功能

19-4、返回值

19-5、说明

19-6、用法

五、推荐阅读

1、Python筑基之旅

2、Python函数之旅

3、Python算法之旅

4、博客个人主页

一、概述

1、定义

        魔法方法(Magic Methods/Special Methods，也称特殊方法或双下划线方法)是Python中一类具有特殊命名规则的方法，它们的名称通常以双下划线(`__`)开头和结尾。

        魔法方法用于在特定情况下自动被Python解释器调用，而不需要显式地调用它们，它们提供了一种机制，让你可以定义自定义类时具有与内置类型相似的行为。

2、作用

        魔法方法允许开发者重载Python中的一些内置操作或函数的行为，从而为自定义的类添加特殊的功能。

二、应用场景

1、构造和析构

1-1、__init__(self, [args...])：在创建对象时初始化属性。
1-2、__new__(cls, [args...])：在创建对象时控制实例的创建过程(通常与元类一起使用)。
1-3、__del__(self)：在对象被销毁前执行清理操作，如关闭文件或释放资源。

2、操作符重载

2-1、__add__(self, other)、__sub__(self, other)、__mul__(self, other)等：自定义对象之间的算术运算。
2-2、__eq__(self, other)、__ne__(self, other)、__lt__(self, other)等：定义对象之间的比较操作。

3、字符串和表示

3-1、__str__(self)：定义对象的字符串表示，常用于print()函数。
3-2、__repr__(self)：定义对象的官方字符串表示，用于repr()函数和交互式解释器。

4、容器管理

4-1、__getitem__(self, key)、__setitem__(self, key, value)、__delitem__(self, key)：用于实现类似列表或字典的索引访问、设置和删除操作。
4-2、__len__(self)：返回对象的长度或元素个数。

5、可调用对象

5-1、__call__(self, [args...])：允许对象像函数一样被调用。

6、上下文管理

6-1、__enter__(self)、__exit__(self, exc_type, exc_val, exc_tb)：用于实现上下文管理器，如with语句中的对象。

7、属性访问和描述符

7-1、__getattr__, __setattr__, __delattr__：这些方法允许对象在访问或修改不存在的属性时执行自定义操作。
7-2、描述符(Descriptors)是实现了__get__, __set__, 和__delete__方法的对象，它们可以控制对另一个对象属性的访问。

8、迭代器和生成器

8-1、__iter__和__next__：这些方法允许对象支持迭代操作，如使用for循环遍历对象。
8-2、__aiter__, __anext__：这些是异步迭代器的魔法方法，用于支持异步迭代。

9、数值类型

9-1、__int__(self)、__float__(self)、__complex__(self)：定义对象到数值类型的转换。
9-2、__index__(self)：定义对象用于切片时的整数转换。

10、复制和序列化

10-1、__copy__和__deepcopy__：允许对象支持浅复制和深复制操作。
10-2、__getstate__和__setstate__：用于自定义对象的序列化和反序列化过程。

11、自定义元类行为

11-1、__metaclass__(Python 2)或元类本身(Python 3)：允许自定义类的创建过程，如动态创建类、修改类的定义等。

12、自定义类行为

12-1、__init__和__new__：用于初始化对象或控制对象的创建过程。
12-2、__init_subclass__：在子类被创建时调用，允许在子类中执行一些额外的操作。

13、类型检查和转换

13-1、__instancecheck__和__subclasscheck__：用于自定义isinstance()和issubclass()函数的行为。

14、自定义异常

14-1、你可以通过继承内置的Exception类来创建自定义的异常类，并定义其特定的行为。

三、学习方法

        要学好Python的魔法方法，你可以遵循以下方法及步骤：

1、理解基础

        首先确保你对Python的基本语法、数据类型、类和对象等概念有深入的理解，这些是理解魔法方法的基础。

2、查阅文档

        仔细阅读Python官方文档中关于魔法方法的部分，文档会详细解释每个魔法方法的作用、参数和返回值。你可以通过访问Python的官方网站或使用help()函数在Python解释器中查看文档。

3、编写示例

        为每个魔法方法编写简单的示例代码，以便更好地理解其用法和效果，通过实际编写和运行代码，你可以更直观地感受到魔法方法如何改变对象的行为。

4、实践应用

        在实际项目中尝试使用魔法方法。如，你可以创建一个自定义的集合类，使用__getitem__、__setitem__和__delitem__方法来实现索引操作。只有通过实践应用，你才能更深入地理解魔法方法的用途和重要性。

5、阅读他人代码

        阅读开源项目或他人编写的代码，特别是那些使用了魔法方法的代码，这可以帮助你学习如何在实际项目中使用魔法方法。通过分析他人代码中的魔法方法使用方式，你可以学习到一些新的技巧和最佳实践。

6、参加社区讨论

        参与Python社区的讨论，与其他开发者交流关于魔法方法的使用经验和技巧，在社区中提问或回答关于魔法方法的问题，这可以帮助你更深入地理解魔法方法并发现新的应用场景。

7、持续学习

        Python语言和其生态系统不断发展，新的魔法方法和功能可能会不断被引入，保持对Python社区的关注，及时学习新的魔法方法和最佳实践。

8、练习与总结

        多做练习，通过编写各种使用魔法方法的代码来巩固你的理解，定期总结你学到的知识和经验，形成自己的知识体系。

9、注意兼容性

        在使用魔法方法时，要注意不同Python版本之间的兼容性差异，确保你的代码在不同版本的Python中都能正常工作。

10、避免过度使用

        虽然魔法方法非常强大，但过度使用可能会导致代码难以理解和维护，在编写代码时，要权衡使用魔法方法的利弊，避免滥用。

        总之，学好Python的魔法方法需要不断地学习、实践和总结，只有通过不断地练习和积累经验，你才能更好地掌握这些强大的工具，并在实际项目中灵活运用它们。

四、魔法方法

17、__float__方法

17-1、语法

__float__(self, /)
    float(self)

17-2、参数

17-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

17-2-2、/(可选)：这是从Python 3.8开始引入的参数注解语法，它表示这个方法不接受任何位置参数(positional-only parameters)之后的关键字参数(keyword arguments)。

17-3、功能

        用于定义一个对象到浮点数的转换规则。

17-4、返回值

        返回一个浮点数。

17-5、说明

        具体来说，以下几种情况可能会触发__float__方法的调用：

17-5-1、使用内置的float函数尝试将一个对象转换为浮点数时。

17-5-2、在需要进行数学运算(如加法、减法、乘法、除法等)的上下文中，如果操作数之一是对

象，而另一个是浮点数或需要浮点数的操作(如除法)，则可能会调用该对象的__float__方法。

17-5-3、在需要浮点数类型的其他内置函数或方法中，如果提供了不支持直接操作的对象，可能会

调用该对象的__float__方法。

17-6、用法

# 017、__float__方法：
# 1、简单的数值类
# 定义一个名为SimpleNumber的类
class SimpleNumber:
    # 类的初始化方法，当创建SimpleNumber对象时自动调用
    def __init__(self, value):
        # 将传入的value参数赋值给对象的value属性
        self.value = value
    # 定义__float__方法，用于将对象转换为浮点数
    def __float__(self):
        # 返回self.value的浮点数形式
        return float(self.value)
# 如果这个脚本作为主程序运行（而不是被导入为模块）
if __name__ == '__main__':
    # 创建一个SimpleNumber对象n，并传入值5.2
    n = SimpleNumber(5.2)
    # 使用内置的float函数和SimpleNumber类的__float__方法将n转换为浮点数
    f = float(n)
    # 打印转换后的浮点数f
    print(f)  # 输出: 5.2

# 2、分数类(有理数)
# 定义一个名为Fraction的类，用于表示分数
class Fraction:
    # 初始化方法，当创建Fraction对象时调用
    def __init__(self, numerator, denominator):
        # 设置分数的分子
        self.numerator = numerator
        # 设置分数的分母
        self.denominator = denominator
    # 定义转换为浮点数的特殊方法
    def __float__(self):
        # 返回分数的浮点数值（即分子除以分母）
        return self.numerator / self.denominator
# 如果这个脚本作为主程序运行（而不是被导入为模块）
if __name__ == '__main__':
    # 创建一个Fraction对象f，分子为3，分母为4
    f = Fraction(3, 4)
    # 使用内置的float函数和Fraction类的__float__方法将f转换为浮点数
    float_f = float(f)
    # 打印转换后的浮点数float_f
    print(float_f)  # 输出: 0.75

# 3、带有单位的度量类(如距离)
# 定义一个名为Distance的类，用于表示距离
class Distance:
    # 初始化方法，用于创建Distance对象时设置距离（以米为单位）
    def __init__(self, meters):
        # 将传入的距离值（以米为单位）赋值给对象的meters属性
        self.meters = meters
    # 定义转换为浮点数的特殊方法
    # 当尝试将Distance对象转换为浮点数时，会调用这个方法
    def __float__(self):
        # 返回Distance对象的meters属性的值，作为浮点数
        return self.meters
# 如果这个脚本作为主程序运行（而不是被导入为模块）
if __name__ == '__main__':
    # 创建一个Distance对象d，表示100.5米的距离
    d = Distance(100.5)
    # 使用内置的float函数和Distance类的__float__方法将d转换为浮点数
    float_d = float(d)
    # 打印转换后的浮点数float_d
    print(float_d)  # 输出: 100.5

# 4、复数类(尽管Python内置了复数类型，但可以作为示例)
# 定义一个名为MyComplex的类，用于表示复数
class MyComplex:
    # 初始化方法，用于创建MyComplex对象时设置实部和虚部
    def __init__(self, real, imag):
        # 设置实部
        self.real = real
        # 设置虚部
        self.imag = imag
    # 定义转换为浮点数的特殊方法
    # 当尝试将MyComplex对象转换为浮点数时，会调用此方法
    def __float__(self):
        # 如果虚部不为0
        if self.imag != 0:
            # 抛出ValueError异常，表示不能将有虚部的复数转换为浮点数
            raise ValueError("Cannot convert complex number with imaginary part to float")
            # 如果虚部为0，则返回实部的浮点数值
        return float(self.real)
# 如果这个脚本作为主程序运行（而不是被导入为模块）
if __name__ == '__main__':
    # 创建一个实部为3，虚部为0的MyComplex对象c
    c = MyComplex(3, 0)
    # 使用内置的float函数和MyComplex类的__float__方法将c转换为浮点数
    f = float(c)
    # 打印转换后的浮点数f
    print(f)  # 输出: 3.0
    try:
        # 创建一个实部为3，虚部为4的MyComplex对象c_with_imag
        c_with_imag = MyComplex(3, 4)
        # 尝试将c_with_imag转换为浮点数，但由于虚部不为0，所以会抛出ValueError异常
        float_c_with_imag = float(c_with_imag)  # 这会抛出ValueError
    except ValueError as e:
        # 捕获ValueError异常并打印异常信息
        print(e)  # 输出: Cannot convert complex number with imaginary part to float

# 5、时间类(转换为以秒为单位的浮点数)
# 从datetime模块中导入timedelta类，timedelta类用于表示两个日期或时间之间的差异
from datetime import timedelta
# 定义一个名为TimeDuration的类，用于封装timedelta并允许通过不同的时间单位进行初始化
class TimeDuration:
    def __init__(self, days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0):
        # 因为timedelta不接受milliseconds参数，并且weeks参数需要转换为days，所以我们先进行计算
        # 将weeks转换为days（1周 = 7天）
        # 注意：在Python 3中，timedelta直接支持weeks参数，但在Python 2中不支持
        td = timedelta(days=days + weeks * 7, seconds=seconds, microseconds=microseconds, minutes=minutes, hours=hours)
        # 如果提供了毫秒（milliseconds），则需要将其转换为秒和微秒
        # 注意：这里我们省略了毫秒的转换，因为timedelta不接受毫秒作为直接参数
        # 如果需要，可以在此添加转换逻辑
        # 将计算好的timedelta赋值给实例的duration属性
        self.duration = td
    # 定义转换为浮点数的特殊方法，返回时间差的总秒数
    def __float__(self):
        # 调用辅助函数total_seconds来获取duration的总秒数
        # 注意：在Python 3中，timedelta有一个total_seconds()方法，但在Python 2中没有
        return total_seconds(self.duration)
# 辅助函数，用于计算timedelta对象的总秒数
# 在Python 2中，timedelta没有直接的total_seconds方法，所以我们自己实现
def total_seconds(td):
    # 计算总秒数，包括天、小时、分钟、秒和微秒
    return (td.microseconds + (td.seconds + td.days * 24 * 3600) * 1e6) / 1e6
if __name__ == '__main__':
    # 创建一个TimeDuration对象，表示1天2小时30分钟的时间差
    td = TimeDuration(days=1, hours=2, minutes=30)
    # 使用内置的float函数和TimeDuration类的__float__方法将td转换为浮点数（总秒数）
    float_td = float(td)
    # 打印转换后的总秒数
    print(float_td)  # 输出: 95400.0（具体取决于你的系统时间精度，但在这个例子中应该是准确的）

# 6、字符串表示的数字转换为浮点数
# 定义一个名为 StringNumber 的类，用于将字符串表示的数字转换为浮点数
class StringNumber:
    # 初始化方法，接收一个字符串类型的数字作为参数
    def __init__(self, number_str):
        # 将接收到的字符串类型的数字保存到实例变量 number_str 中
        self.number_str = number_str
    # 定义转换为浮点数的特殊方法
    # 当尝试将 StringNumber 对象转换为浮点数时，会调用此方法
    def __float__(self):
        # 使用 Python 内置的 float 函数将 number_str 转换为浮点数
        # 并返回这个浮点数
        return float(self.number_str)
# 判断当前脚本是否作为主程序运行（而不是被导入为模块）
if __name__ == '__main__':
    # 创建一个 StringNumber 对象，传入一个表示数字的字符串 "3.14159"
    sn = StringNumber("3.14159")
    # 使用内置的 float 函数和 StringNumber 类的 __float__ 方法将 sn 转换为浮点数
    # 注意：这里实际上不需要显式调用 float(sn)，因为当 sn 被用于需要浮点数的上下文中时，
    # Python 会自动调用 sn 的 __float__ 方法。但为了展示和明确转换，这里显式调用了 float(sn)
    f = float(sn)
    # 打印转换后的浮点数
    print(f)  # 输出: 3.14159

18、__floor__方法

18-1、语法

__floor__(self, /)
    Flooring an Integral returns itself

18-2、参数

18-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

18-2-2、/(可选)：这是从Python 3.8开始引入的参数注解语法，它表示这个方法不接受任何位置参数(positional-only parameters)之后的关键字参数(keyword arguments)。

18-3、功能

        用于定义数值类型的“向下取整”行为。

18-4、返回值

        返回不大于对象所表示数值的最大整数，也就是所谓的“向下取整”或“地板除”的结果。

18-5、说明

        关于返回值，__floor__方法应该返回一个与原始对象相同类型或兼容类型的对象，其值是不大于原始对象所表示数值的最大整数。

18-6、用法

# 018、__floor__方法：
# 1、基本使用
# 定义一个名为 MyNumber 的类，用于封装一个数值并提供一些特殊方法
class MyNumber:
    # 类的初始化方法，用于创建 MyNumber 类的实例
    def __init__(self, value):
        # 将传入的 value 参数赋值给实例变量 self.value
        self.value = value
    # 定义一个特殊方法 __floor__，用于返回 self.value 的向下取整值
    def __floor__(self):
        # 导入 math 模块，尽管在类中导入模块不是最佳实践，但这里为了注释而保留
        import math
        # 调用 math.floor 方法对 self.value 进行向下取整，并返回结果
        return math.floor(self.value)
# 当这个脚本作为主程序运行时，以下代码块会被执行
if __name__ == '__main__':
    # 创建一个 MyNumber 类的实例 num，并传入初始值 3.7
    num = MyNumber(3.7)
    # 调用 num 实例的 __floor__ 方法，并打印返回的结果，即 3.7 的向下取整值
    print(num.__floor__())  # 输出: 3

# 2、自定义运算符中的使用
# 导入math模块，该模块包含了一些数学运算的函数和常量
import math
# 定义一个名为MyNumber的类，用于封装数值并提供自定义的数学运算
class MyNumber:
    # 初始化方法，用于创建MyNumber对象时设置初始值
    def __init__(self, value):
        self.value = value  # 将传入的value赋值给对象的value属性
    # 定义一个特殊方法__floor__，用于返回对象的value属性的向下取整值
    def __floor__(self):
        return math.floor(self.value)  # 使用math模块中的floor函数对value进行向下取整
    # 定义一个特殊方法__int__，用于将MyNumber对象转换为整数
    def __int__(self):
        return int(self.value)  # 定义__int__方法以返回整数值，这里将value转换为整数并返回
    # 定义一个特殊方法__add__，用于实现MyNumber对象之间的加法运算
    def __add__(self, other):
        if isinstance(other, MyNumber):  # 如果other也是MyNumber对象
            return MyNumber(self.value + other.value)  # 返回两个对象value属性之和组成的新MyNumber对象
        else:  # 如果other不是MyNumber对象
            return MyNumber(self.value + other)  # 返回对象value属性与other之和组成的新MyNumber对象
    # 定义一个特殊方法__floordiv__，用于实现MyNumber对象之间的整数除法运算
    def __floordiv__(self, other):
        if isinstance(other, MyNumber):  # 如果other也是MyNumber对象
            floored_self = self.__floor__()  # 对self的value属性进行向下取整
            floored_other = other.__floor__()  # 对other的value属性进行向下取整
            return MyNumber(floored_self // floored_other)  # 返回两个向下取整后的值进行整除运算的结果组成的新MyNumber对象
        else:  # 如果other不是MyNumber对象
            return MyNumber(self.__floor__() // other)  # 对self的value属性进行向下取整，然后与other进行整除运算，返回结果组成的新MyNumber对象
# 当这个脚本作为主程序运行时，以下代码块会被执行
if __name__ == '__main__':
    # 创建两个MyNumber对象num1和num2，并分别设置初始值7.3和2
    num1 = MyNumber(7.3)
    num2 = MyNumber(2)
    # 使用//运算符调用num1的__floordiv__方法，与num2进行整数除法运算，并打印结果
    print(num1 // num2)  # 使用__floordiv__，输出: MyNumber(3)
    # 将num1和num2进行整数除法运算的结果转换为整数并打印
    print(int(num1 // num2))  # 现在可以正确转换为整数，输出: 3

# 3、在类中自动转换
# 定义一个名为MyNumber的类，用于封装数值并提供一些特殊方法
class MyNumber:
    # 类的初始化方法，用于设置对象的初始值
    def __init__(self, value):
        # 将传入的value参数赋值给对象的value属性
        self.value = value
    # 定义一个特殊方法__floor__，用于返回对象value属性的向下取整值
    def __floor__(self):
        # 导入math模块，该模块包含数学相关的函数
        import math
        # 调用math模块中的floor函数对value进行向下取整，并返回结果
        return math.floor(self.value)
    # 定义一个特殊方法__int__，用于将对象转换为整数类型
    def __int__(self):
        # 调用__floor__方法获取value的向下取整值
        # 然后将该值转换为整数类型并返回
        return int(self.__floor__())
# 当这个脚本作为主程序运行时，以下代码块会被执行
if __name__ == '__main__':
    # 创建一个MyNumber对象num，并传入初始值3.7
    num = MyNumber(3.7)
    # 调用num对象的__int__方法，将其转换为整数类型并打印结果
    # 这里通过内置的int函数间接调用了num的__int__方法
    print(int(num))  # 输出: 3

# 4、类的继承与重写
# 定义一个名为MyNumber的类，用于封装数值并提供向下取整的方法
class MyNumber:
    # 类的初始化方法，用于设置对象的初始值
    def __init__(self, value):
        # 将传入的value参数赋值给对象的value属性
        self.value = value
    # 定义一个特殊方法__floor__，用于返回对象value属性的向下取整值
    def __floor__(self):
        # 导入math模块（虽然通常建议在文件顶部导入，但这里为了说明也可在方法内部导入）
        import math
        # 调用math模块中的floor函数对value进行向下取整，并返回结果
        return math.floor(self.value)
    # 定义一个特殊方法__int__，用于将对象转换为整数类型
    def __int__(self):
        # 调用__floor__方法获取value的向下取整值
        # 然后将该值转换为整数类型并返回
        return int(self.__floor__())
# 定义一个继承自MyNumber的SpecialNumber类
class SpecialNumber(MyNumber):
    # 重写父类MyNumber的__floor__方法
    def __floor__(self):
        # 使用super()函数调用父类MyNumber的__floor__方法
        # 然后将返回的结果减1，得到SpecialNumber对象的特殊向下取整值
        return super().__floor__() - 1
# 当这个脚本作为主程序运行时，以下代码块会被执行
if __name__ == '__main__':
    # 创建一个SpecialNumber对象num，并传入初始值4.3
    num = SpecialNumber(4.3)
    # 调用num对象的__int__方法，将其转换为整数类型并打印结果
    # 这里通过内置的int函数间接调用了num的__int__方法
    # SpecialNumber类重写了__floor__方法，所以其__int__方法返回的是特殊向下取整后的整数值
    print(int(num))  # 输出: 3，因为 4.3 向下取整是 4，然后减 1 得到 3

# 5、与其他类型进行比较
# 定义一个名为MyNumber的类，用于封装数值并提供一些特殊方法
class MyNumber:
    # 类的初始化方法，用于设置对象的初始值
    def __init__(self, value):
        # 将传入的value参数赋值给对象的value属性
        self.value = value
    # 定义一个特殊方法__floor__，用于返回对象value属性的向下取整值
    def __floor__(self):
        # 导入math模块（尽管通常在文件顶部导入模块，但在此为了注释说明也可以放在方法内部）
        import math
        # 调用math模块中的floor函数对value进行向下取整，并返回结果
        return math.floor(self.value)
    # 定义一个特殊方法__eq__，用于比较两个对象是否相等
    def __eq__(self, other):
        # 如果other是整数类型
        if isinstance(other, int):
            # 则比较MyNumber对象的向下取整值是否等于other
            return self.__floor__() == other
        # 如果other不是整数类型，则返回NotImplemented，表示不支持该类型的比较
        # 这样可以让Python尝试进行其他类型的比较（如other也是MyNumber对象）
        return NotImplemented
# 当这个脚本作为主程序运行时，以下代码块会被执行
if __name__ == '__main__':
    # 创建一个MyNumber对象num，并传入初始值3.0
    num = MyNumber(3.0)
    # 使用==操作符比较num对象和整数3是否相等
    # 由于num的value是3.0，向下取整后仍为3，所以比较结果为True
    print(num == 3)  # 输出: True

# 6: 自定义格式化输出
# 定义一个名为 MyNumber 的类
class MyNumber:
    # 类的初始化方法，用于创建 MyNumber 类的实例
    def __init__(self, value):
        # 将传入的 value 赋值给实例变量 self.value
        self.value = value
    # 定义一个特殊方法 __floor__，它用于实现取整（向下取整）的功能
    def __floor__(self):
        # 导入 math 模块（尽管这里最好是在文件顶部导入，但为了符合仅注释代码的要求，这里也可以接受）
        import math
        # 使用 math.floor 方法对 self.value 进行向下取整，并返回结果
        return math.floor(self.value)
    # 定义一个特殊方法 __format__，它允许对象自定义其字符串表示形式
    # format_spec 是格式说明符，它描述了如何格式化对象
    def __format__(self, format_spec):
        # 如果格式说明符为 '.floor'，则调用 __floor__ 方法并返回其结果的字符串形式
        if format_spec == '.floor':
            return str(self.__floor__())
            # 如果格式说明符不是 '.floor'，则返回 NotImplemented，表示不支持该格式
        return NotImplemented
# 如果当前运行的脚本（而不是导入的模块）是主程序，则执行以下代码
if __name__ == '__main__':
    # 创建一个 MyNumber 类的实例 num，并传入值 3.7
    num = MyNumber(3.7)
    # 使用 format 函数和 '.floor' 格式说明符来格式化 num 对象，并打印结果
    # 由于 MyNumber 类定义了 __format__ 方法并处理了 '.floor' 格式说明符，因此这里会输出 '3'
    print(format(num, '.floor'))  # 输出: '3'

19、__floordiv__方法

19-1、语法

__floordiv__(self, other, /)
    Return self//other

19-2、参数

19-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

19-2-2、other(必须)：表示与self进行地板除法的另一个值，它可以是任何类型，但通常应该是与

self兼容的数值类型。

19-2-3、/(可选)：这是从Python 3.8开始引入的参数注解语法，它表示这个方法不接受任何位置参数(positional-only parameters)之后的关键字参数(keyword arguments)。

19-3、功能

        用于定义当对象使用//运算符进行地板除法时的行为。

19-4、返回值

        返回一个表示地板除法结果的对象。

19-5、说明

        对于__floordiv__方法，它的返回值通常是与原始对象类型相同或兼容的数值类型对象，其值是两个操作数进行地板除法的结果，然而，这个返回值的具体类型完全取决于你的实现。

19-6、用法

# 019、__floordiv__方法：
# 1、简单的整数类
class SimpleInt:
    def __init__(self, value):
        # 初始化方法，设置实例的 value 属性
        self.value = value
    def __floordiv__(self, other):
        # 定义地板除法运算符的行为
        if isinstance(other, (int, float)):
            # 如果 other 是整数或浮点数，则执行地板除法并返回结果
            return self.value // other
        else:
            # 如果 other 不是整数或浮点数，则抛出类型错误
            raise TypeError("Unsupported operand type(s) for //: 'SimpleInt' and '{}'".format(type(other).__name__))
if __name__ == '__main__':
    # 创建一个 SimpleInt 类的实例 a，并设置其值为 10
    a = SimpleInt(10)
    # 定义一个普通的整数 b，其值为 3
    b = 3
    # 使用 // 运算符调用 a 的 __floordiv__ 方法，并打印结果
    # 这里将输出整数 3，因为 10 // 3 的结果是 3
    print(a // b)  # 这会调用 SimpleInt 的 __floordiv__ 方法，输出应为 3

# 2、自定义除法规则类
class CustomDiv:
    def __init__(self, value):
        # 初始化方法，设置实例的value属性
        self.value = value
    def __floordiv__(self, other):
        # 地板除法特殊方法，用于处理自定义除法规则
        if isinstance(other, int):
            # 检查other是否为整数
            # 如果self.value是非负数，则执行正常的地板除法（即减去余数）
            # 如果self.value是负数，则先取负数的绝对值进行整除，再取负值（因为负数的整除行为是向负无穷方向取整）
            return self.value - (self.value % other) if self.value >= 0 else -((-self.value) // other)
        else:
            # 如果other不是整数，则抛出类型错误
            raise TypeError("Unsupported operand type(s) for //: 'CustomDiv' and '{}'".format(type(other).__name__))
if __name__ == '__main__':
    # 创建一个CustomDiv实例，并设置其value为10
    cd = CustomDiv(10)
    # 调用CustomDiv的__floordiv__方法（即执行cd // 3），并打印结果
    # 因为10 >= 0，所以直接执行self.value - (self.value % other)，即10 - (10 % 3) = 10 - 1 = 9
    print(cd // 3)  # 输出：9
    # 直接使用类名和参数创建另一个CustomDiv实例，其value为-10
    # 调用该实例的__floordiv__方法（即执行CustomDiv(-10) // 3），并打印结果
    # 因为-10 < 0，所以先取-10的绝对值（即10），执行整除10 // 3 = 3，然后取负值，即-3
    print(CustomDiv(-10) // 3)  # 输出：-3（因为-10 < 0, 所以取-((-10) // 3)）

# 3、时间类(用于计算时间差)
from datetime import timedelta
class TimeDuration:
    def __init__(self, hours, minutes, seconds):
        # 初始化方法，接收小时、分钟和秒作为参数，并使用timedelta创建时间差对象
        self.duration = timedelta(hours=hours, minutes=minutes, seconds=seconds)
    def __floordiv__(self, other):
        # 定义地板除法运算符的行为
        if isinstance(other, TimeDuration):
            # 如果 other 是 TimeDuration 的实例，则计算 self 的总秒数与 other 的总秒数
            # 使用整数除法来计算 self 可以包含多少个 other
            # 假设我们想以 other 的时长为单位，计算 self 的时长可以包含多少个 other
            total_seconds = self.duration.total_seconds()  # 获取 self 的总秒数
            other_seconds = other.duration.total_seconds()  # 获取 other 的总秒数
            # 使用整数除法 // 来获取结果，并返回结果
            return int(total_seconds // other_seconds)
        else:
            # 如果 other 不是 TimeDuration 的实例，则抛出类型错误
            raise TypeError(f"Unsupported operand type(s) for //: 'TimeDuration' and '{type(other).__name__}'")
    def __str__(self):
        # 定义字符串表示方法，返回 timedelta 对象的字符串表示
        return str(self.duration)
if __name__ == '__main__':
    # 创建一个 TimeDuration 对象 duration_a，表示 2 小时 30 分钟
    duration_a = TimeDuration(2, 30, 0)  # 2小时30分钟
    # 创建一个 TimeDuration 对象 duration_b，表示 15 分钟
    duration_b = TimeDuration(0, 15, 0)  # 15分钟
    # 使用地板除法运算符 // 来计算 duration_a 包含多少个 duration_b
    # 输出结果应为 10，因为 2 小时 30 分钟 包含 10 个 15 分钟
    print(duration_a // duration_b)  # 输出: 10 (因为 2小时30分钟 包含 10个15分钟)

# 4、自定义货币类(用于货币除法并取整)
class Currency:
    def __init__(self, amount, currency_code='USD'):
        # 初始化方法，接受货币金额和货币代码作为参数，默认为USD
        self.amount = float(amount)
        # 将货币金额转换为浮点数并存储在self.amount中
        self.currency_code = currency_code
        # 存储货币代码在self.currency_code中
    def __floordiv__(self, other):
        # 定义地板除法运算符的行为
        if isinstance(other, (int, float, Currency)):
            # 检查其他对象是否为整数、浮点数或Currency的实例
            if isinstance(other, Currency):
                # 如果其他对象是Currency的实例，则提取其金额
                other_amount = other.amount
            else:
                # 如果其他对象是整数或浮点数，则将其转换为浮点数
                other_amount = float(other)
            # 使用Python内置的整数除法//来计算结果，并创建一个新的Currency对象来存储结果
            return Currency(self.amount // other_amount, self.currency_code)
        else:
            # 如果其他对象不是整数、浮点数或Currency的实例，则抛出TypeError
            raise TypeError(f"Unsupported operand type(s) for //: 'Currency' and '{type(other).__name__}'")
    def __str__(self):
        # 定义字符串表示方法，返回货币金额和货币代码的字符串表示
        return f"{self.amount} {self.currency_code}"
if __name__ == '__main__':
    # 创建一个Currency对象money_a，表示100.00 USD
    money_a = Currency(100.00)
    # 创建一个Currency对象money_b，表示20.00 USD
    money_b = Currency(20.00)
    # 使用地板除法运算符//计算money_a除以money_b的结果，并打印结果，预期输出: 5.0 USD
    print(money_a // money_b)  # 输出: 5.0 USD (注意这里虽然用浮点数表示，但实际是整数除法)
    # 使用浮点数2作为除数，再次计算money_a的结果，并打印结果，预期输出: 50.0 USD
    # 注意这里由于self.amount是浮点数，而//是整数除法，但在Python 3中，//对于浮点数执行的是向下取整的除法
    print(money_a // 2)  # 输出: 50.0 USD

五、推荐阅读

1、Python筑基之旅

2、Python函数之旅

3、Python算法之旅

4、博客个人主页