sync with cpython ea26c885

Author: github-actions[bot]

library/array.po

@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-07-30 00:18+0000\n"
+"POT-Creation-Date: 2026-01-12 00:16+0000\n"
 "PO-Revision-Date: 2021-11-23 18:40+0800\n"
 "Last-Translator: Benson Chen <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -27,13 +27,14 @@ msgid ":mod:`!array` --- Efficient arrays of numeric values"
 msgstr ":mod:`!array` --- 高效率的數值型陣列"
 
 #: ../../library/array.rst:11
+#, fuzzy
 msgid ""
 "This module defines an object type which can compactly represent an array of "
 "basic values: characters, integers, floating-point numbers.  Arrays are "
-"sequence types and behave very much like lists, except that the type of "
-"objects stored in them is constrained.  The type is specified at object "
-"creation time by using a :dfn:`type code`, which is a single character.  The "
-"following type codes are defined:"
+"mutable :term:`sequence` types and behave very much like lists, except that "
+"the type of objects stored in them is constrained.  The type is specified at "
+"object creation time by using a :dfn:`type code`, which is a single "
+"character.  The following type codes are defined:"
 msgstr ""
 "這個模組定義了一個物件型別，可以簡潔的表達一個包含基本數值的陣列：字元、整"
 "數、浮點數。陣列是一個非常類似 list（串列）的序列型別，除了陣列會限制儲存的物"
@@ -280,13 +281,14 @@ msgstr ""
 "之中來將初始項目新增至陣列。"
 
 #: ../../library/array.rst:96
+#, fuzzy
 msgid ""
-"Array objects support the ordinary sequence operations of indexing, slicing, "
-"concatenation, and multiplication.  When using slice assignment, the "
-"assigned value must be an array object with the same type code; in all other "
-"cases, :exc:`TypeError` is raised. Array objects also implement the buffer "
-"interface, and may be used wherever :term:`bytes-like objects <bytes-like "
-"object>` are supported."
+"Array objects support the ordinary :ref:`mutable <typesseq-mutable>` :term:"
+"`sequence` operations of indexing, slicing, concatenation, and "
+"multiplication.  When using slice assignment, the assigned value must be an "
+"array object with the same type code; in all other cases, :exc:`TypeError` "
+"is raised. Array objects also implement the buffer interface, and may be "
+"used wherever :term:`bytes-like objects <bytes-like object>` are supported."
 msgstr ""
 "陣列支援常見的序列操作，包含索引 (indexing)、切片 (slicing)、串接 "
 "(concatenation)、相乘 (multiplication) 等。當使用切片進行賦值時，賦值的陣列必"
@@ -361,10 +363,9 @@ msgstr "回傳 *x* 在陣列中出現了幾次。"
 #: ../../library/array.rst:154
 msgid ""
 "Append items from *iterable* to the end of the array.  If *iterable* is "
-"another array, it must have *exactly* the same type code; if "
-"not, :exc:`TypeError` will be raised.  If *iterable* is not an array, it "
-"must be iterable and its elements must be the right type to be appended to "
-"the array."
+"another array, it must have *exactly* the same type code; if not, :exc:"
+"`TypeError` will be raised.  If *iterable* is not an array, it must be "
+"iterable and its elements must be the right type to be appended to the array."
 msgstr ""
 "從 *iterable* 中新增元素到陣列的尾端，如果 *iterable* 是另一個陣列，它必須有"
 "完全相同的 type code，如果不同會導致 :exc:`TypeError`。如果 *iterable* 不是一"
@@ -374,8 +375,8 @@ msgstr ""
 #: ../../library/array.rst:162
 msgid ""
 "Appends items from the :term:`bytes-like object`, interpreting its content "
-"as an array of machine values (as if it had been read from a file using "
-"the :meth:`fromfile` method)."
+"as an array of machine values (as if it had been read from a file using the :"
+"meth:`fromfile` method)."
 msgstr ""
 "從 :term:`bytes-like object` 中新增元素。讀取時會將其內容當作一個機器數值組成"
 "的陣列（就像從檔案中使用 :meth:`fromfile` 方法讀出的資料）。"
@@ -411,9 +412,9 @@ msgid ""
 "an array of some other type."
 msgstr ""
 "用給定的 Unicode 字串擴展這個陣列。陣列的 type code 必須是 ``u`` 或 ``'w'``；"
-"其他的型別會導致 :exc:`ValueError` 被引發。使用 "
-"``array.frombytes(unicodestring.encode(enc))`` 來新增 Unicode 資料到一個其他"
-"型別的陣列。"
+"其他的型別會導致 :exc:`ValueError` 被引發。使用 ``array."
+"frombytes(unicodestring.encode(enc))`` 來新增 Unicode 資料到一個其他型別的陣"
+"列。"
 
 #: ../../library/array.rst:194
 msgid ""

library/itertools.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-09-08 15:25+0800\n"
+"POT-Creation-Date: 2026-01-12 00:16+0000\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-"
@@ -158,7 +158,8 @@ msgid "(p0, p1, ..., p_n-1), ..."
 msgstr "(p0, p1, ..., p_n-1), ..."
 
 #: ../../library/itertools.rst:50
-msgid "``batched('ABCDEFG', n=2) → AB CD EF G``"
+#, fuzzy
+msgid "``batched('ABCDEFG', n=3) → ABC DEF G``"
 msgstr "``batched('ABCDEFG', n=2) → AB CD EF G``"
 
 #: ../../library/itertools.rst:51
@@ -509,10 +510,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 ""
@@ -591,9 +592,10 @@ msgstr ""
 "[('roses', 'red'), ('violets', 'blue'), ('sugar', 'sweet')]"
 
 #: ../../library/itertools.rst:183
+#, fuzzy
 msgid ""
 "def batched(iterable, n, *, strict=False):\n"
-"    # batched('ABCDEFG', 2) → AB CD EF G\n"
+"    # batched('ABCDEFG', 3) → ABC DEF G\n"
 "    if n < 1:\n"
 "        raise ValueError('n must be at least one')\n"
 "    iterator = iter(iterable)\n"
@@ -666,9 +668,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)!"
@@ -836,8 +838,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` 一起使用來增加序列號。大致等價於： ::"
@@ -1017,9 +1019,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` 物件前進時，前一個群組將不再可見。因此，如果之後需"
@@ -1232,11 +1234,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 ""
@@ -1249,13 +1251,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 ""
@@ -1520,15 +1522,14 @@ 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."
@@ -1606,9 +1607,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 ""
 "當輸入的 *iterable* 已經是一個 tee 疊代物件時，回傳的 tuple（元組）中所有成員"
 "都會被建立，就如同它們是由上游的 :func:`tee` 呼叫所產生的一樣。這個「展平步"
@@ -1658,19 +1659,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*."
@@ -1736,9 +1737,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`）。"
@@ -1761,16 +1762,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 ""
@@ -1789,8 +1790,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"
@@ -1811,16 +1812,17 @@ 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
+#, fuzzy
 msgid ""
 "from collections import Counter, deque\n"
 "from contextlib import suppress\n"
 "from functools import reduce\n"
 "from math import comb, prod, sumprod, isqrt\n"
-"from operator import itemgetter, getitem, mul, neg\n"
+"from operator import is_not, itemgetter, getitem, mul, neg\n"
 "\n"
 "def take(n, iterable):\n"
 "    \"Return first n items of the iterable as a list.\"\n"
@@ -1960,6 +1962,17 @@ msgid ""
 "    slices = starmap(slice, combinations(range(len(seq) + 1), 2))\n"
 "    return map(getitem, repeat(seq), slices)\n"
 "\n"
+"def derangements(iterable, r=None):\n"
+"    \"Produce r length permutations without fixed points.\"\n"
+"    # derangements('ABCD') → BADC BCDA BDAC CADB CDAB CDBA DABC DCAB DCBA\n"
+"    # Algorithm credited to Stefan Pochmann\n"
+"    seq = tuple(iterable)\n"
+"    pos = tuple(range(len(seq)))\n"
+"    have_moved = map(map, repeat(is_not), repeat(pos), permutations(pos, "
+"r=r))\n"
+"    valid_derangements = map(all, have_moved)\n"
+"    return compress(permutations(seq, r=r), valid_derangements)\n"
+"\n"
 "def iter_index(iterable, value, start=0, stop=None):\n"
 "    \"Return indices where a value occurs in a sequence or iterable.\"\n"
 "    # iter_index('AABCADEAF', 'A') → 0 1 4 7\n"
@@ -2152,11 +2165,11 @@ msgstr ""
 "        while True:\n"
 "            yield function()"
 
-#: ../../library/itertools.rst:1008
+#: ../../library/itertools.rst:1018
 msgid "The following recipes have a more mathematical flavor:"
 msgstr "以下的應用技巧具有更多的數學風格："
 
-#: ../../library/itertools.rst:1010
+#: ../../library/itertools.rst:1020
 msgid ""
 "def multinomial(*counts):\n"
 "    \"Number of distinct arrangements of a multiset.\"\n"