python中functools模块简介

朱什么凡

已于 2024-07-01 15:32:55 修改

阅读量793

点赞数 13

文章标签： python java 开发语言

于 2024-07-01 11:19:14 首次发布

本文链接：https://blog.csdn.net/weixin_54897474/article/details/140095994

版权

在Python中，functools是一个标准库模块，它包含了一系列函数和装饰器，用于处理函数和可调用对象。这些工具可以帮助你创建可重用的代码，例如创建偏函数、装饰器、缓存结果等。

常用的函数

functools.reduce(func, iterable)：
- 应用一个函数到序列的每个元素上，将其结果组合成一个单一的值。
- 参数：func - 一个二元函数，用于将序列中的元素组合起来。
- 参数：iterable - 一个可迭代对象，包含要处理的元素。
- 返回值：函数应用到序列中所有元素后的结果。
functools.map(func, iterable)：
- 创建一个迭代器，该迭代器将一个函数应用于可迭代对象中的每个元素。
- 参数：func - 一个函数，用于将可迭代对象中的元素映射到新值。
- 参数：iterable - 一个可迭代对象，包含要处理的元素。
- 返回值：一个迭代器，其元素是函数应用到可迭代对象中每个元素的结果。
**functools.partial(func, /, *args, keywords)：
- 创建一个新的函数，该函数是原始函数的一个部分应用。
- 参数：func - 一个可调用的对象。
- 参数：*args - 可变参数，用于固定原始函数的参数。
- 参数：**keywords - 关键字参数，用于固定原始函数的参数。
- 返回值：一个新的函数，它是原始函数的一个部分应用。
functools.cmp_to_key(func)：
- 将一个比较函数转换为可以作为sorted()和min()函数的关键字参数的函数。
- 参数：func - 一个比较函数。
- 返回值：一个可作为sorted()和min()函数关键字参数的函数。

常用的装饰器

functools.wraps(wrapped)：
- 装饰器，用于包装函数，保留原始函数的元信息，如名称、文档字符串等。
- 参数：wrapped - 被包装的函数。
- 返回值：一个新的装饰器，它将原始函数的元信息保留在新函数中。
functools.lru_cache(maxsize=128, typed=False)：
- 装饰器，用于实现函数的缓存机制。
- 参数：maxsize - 缓存的最大条目数。
- 参数：typed - 如果为True，则缓存将基于参数类型进行区分。
- 返回值：一个装饰器，用于装饰函数，使其结果可以被缓存。

详细讲解`functools.wraps`

functools.wraps装饰器用于包装函数，以保留原始函数的元信息。这有助于保持代码的可读性和可维护性，因为它允许你覆盖原始函数的名称和文档字符串，同时仍然保留这些信息。

例如，假设你有一个函数my_function，你想创建一个新的函数my_new_function，它覆盖了原始函数的名称和文档字符串，但仍然需要保留原始函数的元信息：

import functools

def my_function(x, y):
    """
    This is the original function.
    """
    return x + y

my_new_function = functools.wraps(my_function)(lambda x, y: x - y)

print(my_new_function.__name__)  # 输出: my_function
print(my_new_function.__doc__)  # 输出: This is the original function.

在这个例子中，functools.wraps(my_function)创建了一个新的装饰器，它保留了my_function的元信息。然后，我们使用这个装饰器来包装一个新的函数lambda x, y: x - y，它覆盖了原始函数的名称和文档字符串。

使用functools.wraps装饰器是一个好的编程实践，因为它有助于保持代码的一致性和可读性。<|user|>

元信息

在Python中，元信息（metadata）通常指的是与对象相关的额外信息，这些信息可能包括对象的名称、描述、创建时间、作者等。对于函数和类这样的对象，元信息可以包括函数的名称、文档字符串、参数列表、返回类型等。

在Python中，函数和类都有访问这些元信息的特殊属性，例如：

函数的元信息：
- __name__：函数的名称。
- __doc__：函数的文档字符串。
- __code__：函数的编译后的代码对象。
- __defaults__：函数的默认参数值。
- __kwdefaults__：函数的关键字默认参数值。
- __closure__：函数的闭包。
- __annotations__：函数的类型注解。
类的元信息：
- __name__：类的名称。
- __doc__：类的文档字符串。
- __module__：定义类的模块名称。
- __bases__：类的基类元组。
- __dict__：类的所有属性和方法的字典。
- __annotations__：类的类型注解。