目录
一、概述
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的魔法方法需要不断地学习、实践和总结，只有通过不断地练习和积累经验，你才能更好地掌握这些强大的工具，并在实际项目中灵活运用它们。
四、应用示例
1、__abs__方法
1-1、语法
python
__abs__(self, /)
abs(self)1-2、参数
**1-2-1、self(必须)：**调用该方法的对象本身。
**1-2-2、/(可选)：**这是从Python 3.8开始引入的参数注解语法，它表示这个方法不接受任何位置参数(positional-only parameters)之后的关键字参数(keyword arguments)。
1-3、功能
定义当使用内置的abs()函数作用于一个对象时，该对象应该如何计算其绝对值或模(magnitude)。
1-4、返回值
返回一个非负值，表示该对象的"大小"或"绝对值"。
1-5、说明
该方法通常用于自定义数值类型或需要支持绝对值运算的类。
1-6、用法
python
# 001、__abs__方法：
# 1、定义一个简单的数值类
class Number:
def __init__(self, value):
self.value = value
def __abs__(self):
return abs(self.value)
# 使用示例
num = Number(-5)
print(abs(num)) # 输出: 5，调用了__abs__方法
# 2、定义一个复数类
import math
class ComplexNumber:
def __init__(self, real, imag):
self.real = real
self.imag = imag
def __abs__(self):
return math.sqrt(self.real ** 2 + self.imag ** 2)
# 使用示例
cnum = ComplexNumber(3, 4)
print(abs(cnum)) # 输出: 5.0（因为 3^2 + 4^2 = 25, sqrt(25) = 5）
# 3、定义一个有理数类
class RationalNumber:
def __init__(self, numerator, denominator):
self.numerator = numerator
self.denominator = denominator
self.reduce() # 假设我们有一个reduce方法来简化分数
def reduce(self):
# 这里只是一个简单的示例，真实情况可能需要更复杂的逻辑来简化分数
gcd = math.gcd(abs(self.numerator), abs(self.denominator))
self.numerator //= gcd
self.denominator //= gcd
def __abs__(self):
return RationalNumber(abs(self.numerator), self.denominator)
def __str__(self):
return f"{self.numerator}/{self.denominator}"
# 使用示例
rat = RationalNumber(-4, 2)
print(abs(rat)) # 输出: 2/1 或 2（取决于你如何定义 __str__ 方法）
# 4、定义一个向量类
class Vector:
def __init__(self, x, y):
self.x = x
self.y = y
def __abs__(self):
return (self.x ** 2 + self.y ** 2) ** 0.5
# 使用示例
v = Vector(3, 4)
print(abs(v)) # 输出: 5.0（向量的模长或绝对值）2、__add__方法
2-1、语法
python
__add__(self, other, /)
Return self + other2-2、参数
2-2-1、self**(必须)****：**表示调用该方法的对象本身。
2-2-2、other**(必须)****：**表示与self进行相加操作的对象。
**2-2-3、/(可选)：**这是从Python 3.8开始引入的参数注解语法，它表示这个方法不接受任何位置参数(positional-only parameters)之后的关键字参数(keyword arguments)。
2-3、功能
用于定义当对象使用"+"运算符进行加法运算时的行为。
2-4、返回值
返回一个值，这个值通常表示两个对象相加的结果。
2-5、说明
返回值可以是任何类型，但通常它应该是与原始对象类型相同或兼容的类型。
2-6、用法
python
# 002、__add__方法：
# 1、整数类的简单加法
class Integer:
def __init__(self, value):
self.value = value
def __add__(self, other):
if isinstance(other, Integer):
return Integer(self.value + other.value)
elif isinstance(other, int):
return Integer(self.value + other)
else:
raise TypeError("Unsupported operand types for +: 'Integer' and '{}'".format(type(other).__name__))
def __repr__(self):
return "Integer({})".format(self.value)
# 使用示例
a = Integer(5)
b = Integer(3)
c = a + b # 调用 a.__add__(b)
print(c) # 输出: Integer(8)
d = a + 2 # 调用 a.__add__(2)
print(d) # 输出: Integer(7)
# 2、向量类的向量加法
class Vector:
def __init__(self, x, y):
self.x = x
self.y = y
def __add__(self, other):
if isinstance(other, Vector):
return Vector(self.x + other.x, self.y + other.y)
else:
raise TypeError("Unsupported operand types for +: 'Vector' and '{}'".format(type(other).__name__))
def __repr__(self):
return "Vector({}, {})".format(self.x, self.y)
# 使用示例
v1 = Vector(1, 2)
v2 = Vector(3, 4)
v3 = v1 + v2 # 调用 v1.__add__(v2)
print(v3) # 输出: Vector(4, 6)3、__and__方法
3-1、语法
python
__and__(self, other, /)
Return self & other3-2、参数
3-2-1、self**(必须)****：**表示调用该方法的对象本身。
3-2-2、other**(必须)****：**表示与self进行按位与操作的对象。
**3-2-3、/(可选)：**这是从Python 3.8开始引入的参数注解语法，它表示这个方法不接受任何位置参数(positional-only parameters)之后的关键字参数(keyword arguments)。
3-3、功能
用于定义对象之间按位与(bitwise AND)操作的行为。
3-4、返回值
返回一个值或另一种类型的对象，这个值表示两个操作数按位与的结果。
3-5、说明
返回值可以是任何类型，但通常它会返回与操作数相同类型的一个新对象，或者在某些情况下返回另一种类型的对象(只要这个结果是按位与操作的逻辑结果)。
3-6、用法
python
# 003、__and__方法：
class BitField:
def __init__(self, value):
self.value = value
def __and__(self, other):
# 检查other是否为BitField或整数
if isinstance(other, BitField):
other_value = other.value
elif isinstance(other, int):
other_value = other
else:
raise TypeError(f"Unsupported operand type for &: 'BitField' and '{type(other).__name__}'")
# 执行按位与操作并返回新的BitField对象
return BitField(self.value & other_value)
def __repr__(self):
# 返回值的二进制表示（仅用于演示）
return f"BitField(binary: {bin(self.value)[2:]}, decimal: {self.value})"
# 使用示例
bf1 = BitField(60) # 60 in binary is 0011 1100
bf2 = BitField(13) # 13 in binary is 0000 1101
# 执行按位与操作
result = bf1 & bf2
print(result) # 输出: BitField(binary: 1100, decimal: 12)
# 也可以与整数进行按位与操作
result_int = bf1 & 5 # 5 in binary is 0000 0101
print(result_int) # 输出: BitField(binary: 100, decimal: 4)4、__bool__方法
4-1、语法
python
__bool__(self, /)
True if self else False4-2、参数
3-2-1、self**(必须)****：**表示调用该方法的对象本身。
**3-2-2、/(可选)：**这是从Python 3.8开始引入的参数注解语法，它表示这个方法不接受任何位置参数(positional-only parameters)之后的关键字参数(keyword arguments)。
4-3、功能
允许类的实例在需要布尔值的上下文中(如if语句、while循环的条件、bool()函数调用等)被正确地评估，即需要根据上下文做出正确的评估。
4-4、返回值
返回一个布尔值，即True或False。
4-5、说明
返回值决定了类的实例在布尔上下文中被视为True还是False。
4-6、用法
python
# 004、__bool__方法：
# 1、基于值的简单示例
class SimpleBool:
def __init__(self, value):
self.value = value
def __bool__(self):
return bool(self.value)
# 使用示例
s1 = SimpleBool(True)
s2 = SimpleBool(False)
s3 = SimpleBool(0)
s4 = SimpleBool(1)
print(bool(s1)) # 输出: True
print(bool(s2)) # 输出: False
print(bool(s3)) # 输出: False
print(bool(s4)) # 输出: True
if s1:
print("s1 is True") # 输出: s1 is True
if not s2:
print("s2 is False") # 输出: s2 is False
# 2、自定义条件判断
class CustomBool:
def __init__(self, value):
self.value = value
def __bool__(self):
# 假设我们想要当value大于0时返回True
return self.value > 0
# 使用示例
c1 = CustomBool(5)
c2 = CustomBool(-3)
c3 = CustomBool(0)
print(bool(c1)) # 输出: True
print(bool(c2)) # 输出: False
print(bool(c3)) # 输出: False
if c1:
print("c1 is greater than 0") # 输出: c1 is greater than 0
# 3、字符串类，基于内容是否为空
class StringWithBool:
def __init__(self, content):
self.content = content
def __bool__(self):
# 如果内容非空，返回True
return bool(self.content.strip())
# 使用示例
str1 = StringWithBool("Hello, Myelsa!")
str2 = StringWithBool("")
str3 = StringWithBool(" ") # 只有空格
print(bool(str1)) # 输出: True
print(bool(str2)) # 输出: False
print(bool(str3)) # 输出: False（因为strip()移除了空格）
if str1:
print("str1 is not empty") # 输出: str1 is not empty5、__call__方法
5-1、语法
python
__call__(*args, **kwargs)
Call self as a function5-2、参数
5-2-1、*args**(可变位置参数)**：允许你传递任意数量的位置参数给函数。
5-2-2、**kwargs(可变关键字参数)：允许你传递任意数量的关键字参数给函数。
5-3、功能
为类的实例提供函数式调用的能力。
5-4、返回值
可以是任何类型，具体取决于你的实现，就像普通的函数一样，你可以从__call__方法中返回任何你想要的值或对象。
5-5、说明
当实例被调用时(即使用圆括号和可能的参数)，Python会自动调用该实例的__call__方法，并将括号中的参数传递给该方法。
5-6、用法
python
# 005、__call__方法：
# 1、简单的函数式类
class Greeter:
def __init__(self, name):
self.name = name
def __call__(self, greeting="Hello"):
return f"{greeting}, {self.name}!"
# 使用示例
greeter = Greeter("Myelsa")
print(greeter("Hi")) # 输出: Hi, Myelsa!
print(greeter()) # 输出: Hello, Myelsa!（因为默认参数是"Hello"）
# 2、计算器类
class Calculator:
def __init__(self, initial_value=0):
self.value = initial_value
def __call__(self, operand, operation="+"):
if operation == "+":
self.value += operand
elif operation == "-":
self.value -= operand
# 可以添加更多操作，如乘法、除法等
return self.value
# 使用示例
calc = Calculator(10)
print(calc(5)) # 输出: 15（执行加法操作）
print(calc(3, "-")) # 输出: 12（执行减法操作）
# 3、可调用对象作为装饰器
class MyDecorator:
def __init__(self, func):
self.func = func
def __call__(self, *args, **kwargs):
print("Before function call.")
result = self.func(*args, **kwargs)
print("After function call.")
return result
# 使用示例
@MyDecorator
def say_hello(name):
print(f"Hello, {name}!")
say_hello("Jimmy")
# 输出:
# Before function call.
# Hello, Jimmy!
# After function call.
# 4、作为装饰器的类
class Timer:
def __init__(self, func):
self.func = func
def __call__(self, *args, **kwargs):
import time
start_time = time.time()
result = self.func(*args, **kwargs)
end_time = time.time()
print(f"Function {self.func.__name__} took {end_time - start_time:.6f}s to execute.")
return result
# 使用示例
@Timer
def slow_function():
import time
time.sleep(1) # 模拟耗时操作
return "Done"
print(slow_function()) # 输出执行时间以及 "Done"
# 5、具有状态的函数式类
class Counter:
def __init__(self, start=0):
self.count = start
def __call__(self):
self.count += 1
return self.count
# 使用示例
counter = Counter(5)
print(counter()) # 输出: 6
print(counter()) # 输出: 7
print(counter()) # 输出: 8