sync with cpython f7af8bc5

Author: github-actions[bot]

c-api/init.po

@@ -807,8 +807,8 @@ msgid ""
 "example, given the function definition::"
 msgstr ""
 ":term:`參數 <parameter>`\\ 由出現在函式定義中的名稱定義，而\\ :term:`引數 "
-"<argument>`\\ 是呼叫函式時實際傳遞給函式的值。參數定義函式可以接受的\\ :term:"
-"引數種類 <parameter>`。例如，給定以下函式定義： ::"
+"<argument>`\\ 是呼叫函式時實際傳遞給函式的值。參數定義函式可以接受的"
+"\\ :term:`引數種類 <parameter>`。例如，給定以下函式定義： ::"
 
 #: ../../faq/programming.rst:423
 msgid ""
@@ -3029,8 +3029,9 @@ msgid ""
 "To test for \"true inheritance\", scan the :term:`MRO` of the class:"
 msgstr ""
 "請注意，:func:`isinstance` 還會檢查來自\\ :term:`抽象基底類別 (abstract base "
-"class)` 的虛擬繼承。因此對已註冊類別的檢驗會回傳 ``True``，即使沒有直接或間接"
-"繼承自它。要測試「真正繼承」，請掃描該類別的 :term:`MRO`："
+"class) <abstract base class>` 的虛擬繼承。因此對已註冊類別的檢驗會回傳 "
+"``True``，即使沒有直接或間接繼承自它。要測試「真正繼承」，請掃描該類別"
+"的 :term:`MRO`："
 
 #: ../../faq/programming.rst:1516
 msgid ""

faq/programming.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-17 00:14+0000\n"
+"POT-Creation-Date: 2025-02-07 15:02+0800\n"
 "PO-Revision-Date: 2024-08-16 15:01+0800\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -488,10 +488,10 @@ msgid ""
 "www.ramseysolutions.com/real-estate/amortization-schedule>`_, accumulate the "
 "interest and apply payments:"
 msgstr ""
-"*function* 引數可以被設定為 :func:`min` 以得到連續的最小值，設定為 :func:"
-"`max` 以得到連續的最大值，或者設定為 :func:`operator.mul` 以得到連續的乘積。"
-"也可以透過累積利息和付款來建立\\ `攤銷表 (Amortization tables) <https://www."
-"ramseysolutions.com/real-estate/amortization-schedule>`_ ："
+"*function* 引數可以被設定為 :func:`min` 以得到連續的最小值，設定"
+"為 :func:`max` 以得到連續的最大值，或者設定為 :func:`operator.mul` 以得到連續"
+"的乘積。也可以透過累積利息和付款來建立\\ `攤銷表 (Amortization tables) "
+"<https://www.ramseysolutions.com/real-estate/amortization-schedule>`_ ："
 
 #: ../../library/itertools.rst:136
 msgid ""
@@ -630,9 +630,9 @@ msgstr "從輸入 *iterable* 中回傳長度為 *r* 的元素的子序列。"
 #: ../../library/itertools.rst:227
 msgid ""
 "The output is a subsequence of :func:`product` keeping only entries that are "
-"subsequences of the *iterable*.  The length of the output is given by :func:"
-"`math.comb` which computes ``n! / r! / (n - r)!`` when ``0 ≤ r ≤ n`` or zero "
-"when ``r > n``."
+"subsequences of the *iterable*.  The length of the output is given "
+"by :func:`math.comb` which computes ``n! / r! / (n - r)!`` when ``0 ≤ r ≤ "
+"n`` or zero when ``r > n``."
 msgstr ""
 "輸出是 :func:`product` 的子序列，僅保留作為 *iterable* 子序列的條目。輸出的長"
 "度由 :func:`math.comb` 給定，當 ``0 ≤ r ≤ n`` 時，長度為 ``n! / r! / (n - r)!"
@@ -758,8 +758,8 @@ msgstr ""
 #: ../../library/itertools.rst:323
 msgid ""
 "Make an iterator that returns evenly spaced values beginning with *start*. "
-"Can be used with :func:`map` to generate consecutive data points or with :"
-"func:`zip` to add sequence numbers.  Roughly equivalent to::"
+"Can be used with :func:`map` to generate consecutive data points or "
+"with :func:`zip` to add sequence numbers.  Roughly equivalent to::"
 msgstr ""
 "建立一個疊代器，回傳從 *start* 開始的等差的值。可以與 :func:`map` 一起使用來"
 "產生連續的資料點，或與 :func:`zip` 一起使用來增加序列號。大致等價於： ::"
@@ -939,9 +939,9 @@ msgstr ""
 #: ../../library/itertools.rst:420
 msgid ""
 "The returned group is itself an iterator that shares the underlying iterable "
-"with :func:`groupby`.  Because the source is shared, when the :func:"
-"`groupby` object is advanced, the previous group is no longer visible.  So, "
-"if that data is needed later, it should be stored as a list::"
+"with :func:`groupby`.  Because the source is shared, when "
+"the :func:`groupby` object is advanced, the previous group is no longer "
+"visible.  So, if that data is needed later, it should be stored as a list::"
 msgstr ""
 "回傳的群組本身是一個與 :func:`groupby` 共享底層可疊代物件的疊代器。由於來源是"
 "共享的，當 :func:`groupby` 物件前進時，前一個群組將不再可見。因此，如果之後需"
@@ -1146,11 +1146,11 @@ msgstr ""
 
 #: ../../library/itertools.rst:536
 msgid ""
-"Return successive *r* length `permutations of elements <https://www."
-"britannica.com/science/permutation>`_ from the *iterable*."
+"Return successive *r* length `permutations of elements <https://"
+"www.britannica.com/science/permutation>`_ from the *iterable*."
 msgstr ""
-"回傳 *iterable* 中連續且長度為 *r* 的\\ `元素排列 <https://www.britannica."
-"com/science/permutation>`_ 。"
+"回傳 *iterable* 中連續且長度為 *r* 的\\ `元素排列 <https://"
+"www.britannica.com/science/permutation>`_ 。"
 
 #: ../../library/itertools.rst:539
 msgid ""
@@ -1163,13 +1163,13 @@ msgstr ""
 #: ../../library/itertools.rst:543
 msgid ""
 "The output is a subsequence of :func:`product` where entries with repeated "
-"elements have been filtered out.  The length of the output is given by :func:"
-"`math.perm` which computes ``n! / (n - r)!`` when ``0 ≤ r ≤ n`` or zero when "
-"``r > n``."
+"elements have been filtered out.  The length of the output is given "
+"by :func:`math.perm` which computes ``n! / (n - r)!`` when ``0 ≤ r ≤ n`` or "
+"zero when ``r > n``."
 msgstr ""
-"輸出是 :func:`product` 的子序列，其中重複元素的條目已被濾除。輸出的長度由 :"
-"func:`math.perm` 給定，當 ``0 ≤ r ≤ n`` 時，長度為 ``n! / (n - r)!``，當 ``r "
-"> n`` 時為零。"
+"輸出是 :func:`product` 的子序列，其中重複元素的條目已被濾除。輸出的長度"
+"由 :func:`math.perm` 給定，當 ``0 ≤ r ≤ n`` 時，長度為 ``n! / (n - r)!``，當 "
+"``r > n`` 時為零。"
 
 #: ../../library/itertools.rst:548
 msgid ""
@@ -1432,14 +1432,15 @@ msgid ""
 "the input iterator and there is no way to access it. This could be an issue "
 "if an application wants to further consume the input iterator after "
 "*takewhile* has been run to exhaustion.  To work around this problem, "
-"consider using `more-itertools before_and_after() <https://more-itertools."
-"readthedocs.io/en/stable/api.html#more_itertools.before_and_after>`_ instead."
+"consider using `more-itertools before_and_after() <https://more-"
+"itertools.readthedocs.io/en/stable/"
+"api.html#more_itertools.before_and_after>`_ instead."
 msgstr ""
 "注意，第一個不符合條件判斷的元素將從輸入疊代器中被消耗，且無法再存取它。如果"
 "應用程式希望在 *takewhile* 耗盡後進一步消耗輸入疊代器，這可能會是個問題。為了"
 "解決這個問題，可以考慮使用 `more-itertools 中的 before_and_after() <https://"
-"more-itertools.readthedocs.io/en/stable/api.html#more_itertools."
-"before_and_after>`_ 作為替代。"
+"more-itertools.readthedocs.io/en/stable/"
+"api.html#more_itertools.before_and_after>`_ 作為替代。"
 
 #: ../../library/itertools.rst:691
 msgid "Return *n* independent iterators from a single iterable."
@@ -1485,9 +1486,9 @@ msgstr ""
 msgid ""
 "When the input *iterable* is already a tee iterator object, all members of "
 "the return tuple are constructed as if they had been produced by the "
-"upstream :func:`tee` call.  This \"flattening step\" allows nested :func:"
-"`tee` calls to share the same underlying data chain and to have a single "
-"update step rather than a chain of calls."
+"upstream :func:`tee` call.  This \"flattening step\" allows "
+"nested :func:`tee` calls to share the same underlying data chain and to have "
+"a single update step rather than a chain of calls."
 msgstr ""
 
 #: ../../library/itertools.rst:734
@@ -1521,19 +1522,19 @@ msgid ""
 "even if the original *iterable* is threadsafe."
 msgstr ""
 "``tee`` 疊代器不是執行緒安全 (threadsafe) 的。當同時使用由同一個 :func:`tee` "
-"呼叫所回傳的疊代器時，即使原始的 *iterable* 是執行緒安全的，也可能引發 :exc:"
-"`RuntimeError`。"
+"呼叫所回傳的疊代器時，即使原始的 *iterable* 是執行緒安全的，也可能引"
+"發 :exc:`RuntimeError`。"
 
 #: ../../library/itertools.rst:758
 msgid ""
 "This itertool may require significant auxiliary storage (depending on how "
 "much temporary data needs to be stored). In general, if one iterator uses "
-"most or all of the data before another iterator starts, it is faster to use :"
-"func:`list` instead of :func:`tee`."
+"most or all of the data before another iterator starts, it is faster to "
+"use :func:`list` instead of :func:`tee`."
 msgstr ""
 "此 itertool 可能需要大量的輔助儲存空間（取決於需要儲存多少臨時資料）。通常如"
-"果一個疊代器在另一個疊代器開始之前使用了大部分或全部的資料，使用 :func:"
-"`list` 會比 :func:`tee` 更快。"
+"果一個疊代器在另一個疊代器開始之前使用了大部分或全部的資料，使"
+"用 :func:`list` 會比 :func:`tee` 更快。"
 
 #: ../../library/itertools.rst:766
 msgid "Make an iterator that aggregates elements from each of the *iterables*."
@@ -1599,9 +1600,9 @@ msgstr ""
 
 #: ../../library/itertools.rst:798
 msgid ""
-"If one of the iterables is potentially infinite, then the :func:"
-"`zip_longest` function should be wrapped with something that limits the "
-"number of calls (for example :func:`islice` or :func:`takewhile`)."
+"If one of the iterables is potentially infinite, then "
+"the :func:`zip_longest` function should be wrapped with something that "
+"limits the number of calls (for example :func:`islice` or :func:`takewhile`)."
 msgstr ""
 "如果其中一個 iterables 可能是無限的，那麼應該用別的可以限制呼叫次數的方法來包"
 "裝 :func:`zip_longest` 函式（例如 :func:`islice` 或 :func:`takewhile`）。"
@@ -1624,16 +1625,16 @@ msgid ""
 "``chain.from_iterable`` is related to the concept of flattening.  The "
 "recipes also give ideas about ways that the tools can be combined — for "
 "example, how ``starmap()`` and ``repeat()`` can work together.  The recipes "
-"also show patterns for using itertools with the :mod:`operator` and :mod:"
-"`collections` modules as well as with the built-in itertools such as "
-"``map()``, ``filter()``, ``reversed()``, and ``enumerate()``."
+"also show patterns for using itertools with the :mod:`operator` "
+"and :mod:`collections` modules as well as with the built-in itertools such "
+"as ``map()``, ``filter()``, ``reversed()``, and ``enumerate()``."
 msgstr ""
 "itertools 應用技巧的主要目的是教學。這些應用技巧展示了對單個工具進行思考的各"
 "種方式 —— 例如，``chain.from_iterable`` 與攤平 (flattening) 的概念相關。這些"
 "應用技巧還提供了組合使用工具的想法 —— 例如，``starmap()`` 和 ``repeat()`` 如"
-"何一起工作。另外還展示了將 itertools 與 :mod:`operator` 和 :mod:"
-"`collections` 模組一同使用以及與內建 itertools（如 ``map()``、``filter()``、"
-"``reversed()`` 和 ``enumerate()``）一同使用的模式。"
+"何一起工作。另外還展示了將 itertools 與 :mod:`operator` "
+"和 :mod:`collections` 模組一同使用以及與內建 itertools（如 ``map()``、"
+"``filter()``、``reversed()`` 和 ``enumerate()``）一同使用的模式。"
 
 #: ../../library/itertools.rst:820
 msgid ""
@@ -1652,8 +1653,8 @@ msgid ""
 "Substantially all of these recipes and many, many others can be installed "
 "from the :pypi:`more-itertools` project found on the Python Package Index::"
 msgstr ""
-"幾乎所有這些應用技巧以及許多其他應用技巧都可以從 Python Package Index 上的 :"
-"pypi:`more-itertools` 專案中安裝： ::"
+"幾乎所有這些應用技巧以及許多其他應用技巧都可以從 Python Package Index 上"
+"的 :pypi:`more-itertools` 專案中安裝： ::"
 
 #: ../../library/itertools.rst:829
 msgid "python -m pip install more-itertools"
@@ -1674,15 +1675,15 @@ msgstr ""
 "可疊代物件一次性引入記憶體，能保持優異的記憶體性能。以\\ `函式風格 "
 "(functional style) <https://www.cs.kent.ac.uk/people/staff/dat/miranda/"
 "whyfp90.pdf>`_ 將工具連接在一起，能將程式碼的數量維持在較少的情況。透過優先使"
-"用「向量化 (vectorized)」的構建塊而不是使用會造成直譯器負擔的 for 迴圈和\\ :"
-"term:`產生器 <generator>`，則能保持高速度。"
+"用「向量化 (vectorized)」的構建塊而不是使用會造成直譯器負擔的 for 迴圈和"
+"\\ :term:`產生器 <generator>`，則能保持高速度。"
 
 #: ../../library/itertools.rst:839
 msgid ""
-"from collections import deque\n"
+"from collections import Counter, deque\n"
 "from contextlib import suppress\n"
 "from functools import reduce\n"
-"from math import sumprod, isqrt\n"
+"from math import comb, prod, sumprod, isqrt\n"
 "from operator import itemgetter, getitem, mul, neg\n"
 "\n"
 "def take(n, iterable):\n"
@@ -1972,7 +1973,13 @@ msgid ""
 "    # totient(12) → 4 because len([1, 5, 7, 11]) == 4\n"
 "    for prime in set(factor(n)):\n"
 "        n -= n // prime\n"
-"    return n"
+"    return n\n"
+"\n"
+"def multinomial(*counts):\n"
+"    \"Number of distinct arrangements of a multiset.\"\n"
+"    # Counter('abracadabra').values() -> 5 2 1 1 2\n"
+"    # multinomial(5, 2, 1, 1, 2) → 83160\n"
+"    return prod(map(comb, accumulate(counts), counts))"
 msgstr ""
 
 #~ msgid ""