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

python functools.partialmethod 函数介绍

article 2025/1/13 12:20:18

functools.partialmethod 是 Python 标准库 functools 模块中的一个函数，用于为 类的方法 创建一个 偏函数（partial function）。它允许你预设某些参数的值，从而在调用方法时省略这些参数。

与 functools.partial 类似，partialmethod 专门用于类方法的场景。

`partialmethod` 的作用

简化类方法调用：通过预设参数，可以创建更简洁的接口。
代码复用：减少重复代码，将逻辑封装到一个基础方法中。
提高可读性：针对特定用途，定义更易理解的类方法。

函数签名

functools.partialmethod(func, /, *args, **keywords)

参数说明：

func：需要进行偏函数化的原始方法。
*args：预设的 位置参数。
**keywords：预设的 关键字参数。

返回值：

返回一个新的方法，调用时可以省略预设的参数。

示例代码

1. 基础用法

from functools import partialmethod

class MyClass:
    def greet(self, name, greeting="Hello"):
        return f"{greeting}, {name}!"

    # 使用 partialmethod 预设 greeting 参数
    greet_hello = partialmethod(greet, greeting="Hello")
    greet_hi = partialmethod(greet, greeting="Hi")

# 实例化类
obj = MyClass()

# 调用原始方法
print(obj.greet("Alice"))             # 输出: Hello, Alice!
print(obj.greet("Bob", greeting="Hi"))  # 输出: Hi, Bob!

# 调用偏方法
print(obj.greet_hello("Alice"))      # 输出: Hello, Alice!
print(obj.greet_hi("Bob"))           # 输出: Hi, Bob!

在这个例子中，greet_hello 和 greet_hi 是通过 partialmethod 创建的偏方法，分别将 greeting 参数固定为 "Hello" 和 "Hi"。

2. 在类继承中的使用

from functools import partialmethod

class BaseClass:
    def calculate(self, x, y, z):
        return x + y * z

class DerivedClass(BaseClass):
    calculate_with_fixed_z = partialmethod(BaseClass.calculate, z=10)

# 实例化类
obj = DerivedClass()

# 使用偏方法
result = obj.calculate_with_fixed_z(2, 3)
print(result)  # 输出: 32 (2 + 3 * 10)

在这个例子中，calculate_with_fixed_z 方法继承了 calculate，但将 z 参数固定为 10。

与 `functools.partial` 的区别

适用范围：
- partial：适用于普通函数或方法，返回一个新的可调用对象。
- partialmethod：专为类方法设计，返回一个新的方法，可直接绑定到类实例。
绑定行为：
- partial 创建的偏函数没有自动绑定 self。
- partialmethod 自动绑定 self，与类方法的调用方式一致。