介绍Python 中内置库 functools ------ 可调用对象上的高阶函数和操作 。
简介 {#简介}
Functools 模块用于高阶函数: 作用于或返回其他函数的函数。一般来说,任何可调用对象都可以作为此模块的函数处理。
functools 包含一下模块:
- functools.cache
- functools.cached_property
- functools.cmp_to_key
- functools.lru_cache
- functools.total_ordering
- functools.partial
- functools.partialmethod
- functools.reduce
- functools.singledispatch
- functools.singledispatchmethod
- functools.update_wrapper
- functools.wraps
cache {#cache}
New in version 3.9.
为函数返回结果与输入值创建字典,再次访问时则直接调用结果,缓存没有数量限制。不会删除旧的数据也不会限制内存尺寸,会比 lru_cache(maxsize=size)
轻量且快速。
计算过的值就不会重复计算了。
cached_property {#cached-property}
New in version 3.8.
将类的方法转换为一个属性,该属性的值只计算一次,然后作为实例生命周期的常规属性缓存。
cmp_to_key {#cmp-to-key}
New in version 3.2.
将旧式比较函数转换为关键函数。与接受关键函数的工具一起使用(例如 sort ()、 min ()、 max ()、 heapq.nbest ()、 heapq.nbest ()、 itertools.groupby ())。该函数主要用作从 Python 2转换的程序的转换工具,Python 2支持使用比较函数。
lru_cache {#lru-cache}
修饰符用制表调用包装函数,该调用最多可以保存最新调用的最大值。当使用相同的参数周期性地调用一个昂贵的或 I/O 绑定的函数时,它可以节省时间。
缓存是线程安全的,因此可以在多个线程中使用包装函数。这意味着在并发更新期间,底层数据结构将保持一致。
不同的参数模式可以被认为是具有不同缓存条目的不同调用。例如,f (a = 1,b = 2)和 f (b = 2,a = 1)的关键字参数顺序不同,可能有两个单独的缓存条目。
如果类型化设置为 true,则将分别缓存不同类型的函数参数。如果类型为 false,则实现通常将它们视为等效调用,并且只缓存一个结果。(有些类型,例如 str 和 int,即使类型为 false,也可以单独缓存。)
total_ordering {#total-ordering}
New in version 3.2.
提供简便的方式定义类比较方法,仅需定义 __lt__()
, __le__()
, __gt__()
, or __ge__()
其中之一和 __eq__()
方法即可完成完备的比较定义:
虽然这个装饰符使得创建行为良好的完全有序的类型变得很容易,但它的代价是执行速度较慢,派生比较方法的堆栈跟踪更复杂。如果性能基准测试表明这是给定应用程序的瓶颈,那么实现所有六种富比较方法可能会提供一个简单的速度提升。
partial {#partial}
将函数输入以写死的方式减少个数,返回新的函数接口。
partialmethod {#partialmethod}
New in version 3.4.
返回一个新的 partial 方法描述符,它的行为类似于 partial,只不过它被设计用作方法定义,而不是直接调用。
相当于该方法修改了原始函数,而不是生成一个输入参数更少的新函数。
reduce {#reduce}
迭代计算函数,从左到右计算,将结果放到最左边,直接进行下一次计算。
reduce(lambda x, y: x+y, [1, 2, 3, 4, 5])
等价于 ((((1+2)+3)+4)+5)
singledispatch {#singledispatch}
New in version 3.4.
将函数转换为单分派通用函数。 可以根据输入数据类型不同调用不同的函数。
使用
singledispatchmethod {#singledispatchmethod}
New in version 3.8.
要为类定义一个泛型方法,可以使用 @singlepatchmethod
装饰符对其进行装饰。当使用 @singlepatchmethod
定义函数时,请注意调度发生在第一个非 self 或 non-cls 参数的类型上:
@singlepatchmethod
支持与其他修饰符(如@classmethod)嵌套。注意,为了支持 patcher.register,singlepatchmethod 必须是最外层的装饰器。下面是 Negator 类,其中的 neg 方法绑定到该类,而不是该类的实例:
update_wrapper {#update-wrapper}
New in version 3.2
更新一个包装函式,使其看起来像包装好的函数。可选参数是元组,用于指定原始函数的哪些属性被直接分配给包装函式上的匹配属性,以及哪些包装函式属性被更新为原始函数的相应属性。
wraps {#wraps}
这是一个简写函数,用于在定义包装函式时调用 update_wrapper()
作为函数修饰符。它等效于partial(update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated)
。
参考资料 {#参考资料}
文章链接:
https://www.zywvvd.com/notes/coding/python/python-functools/python-functools/