From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Fri, 14 Sep 2018 08:13:17 +0000 (-0700) Subject: Note that distinct argument patterns can be cached separately (GH-9298) (GH-9299) X-Git-Tag: v3.7.1rc1~67 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a8f189f4571ca16e85d322cb45d1599526dbd9b4;p=thirdparty%2FPython%2Fcpython.git Note that distinct argument patterns can be cached separately (GH-9298) (GH-9299) (cherry picked from commit 902bcd9a1e2c73c6de5510b771c590b618c4c94e) Co-authored-by: Raymond Hettinger --- diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst index a81e819103ad..3413cd353ca9 100644 --- a/Doc/library/functools.rst +++ b/Doc/library/functools.rst @@ -52,6 +52,11 @@ The :mod:`functools` module defines the following functions: Since a dictionary is used to cache results, the positional and keyword arguments to the function must be hashable. + Distinct argument patterns may be considered to be distinct calls with + separate cache entries. For example, `f(a=1, b=2)` and `f(b=2, a=1)` + differ in their keyword argument order and may have two separate cache + entries. + If *maxsize* is set to ``None``, the LRU feature is disabled and the cache can grow without bound. The LRU feature performs best when *maxsize* is a power-of-two.