sync with cpython d61f8b84

github-actions[bot] · web-flow · commit d66eab695676 · 2025-07-30T00:19:50.000Z
diff --git a/library/array.po b/library/array.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-23 07:52+0800\n"
+"POT-Creation-Date: 2025-07-30 00:18+0000\n"
 "PO-Revision-Date: 2021-11-23 18:40+0800\n"
 "Last-Translator: Benson Chen <bc842017@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -123,6 +123,10 @@ msgstr "Py_UCS4"
 msgid "4"
 msgstr "4"
 
+#: ../../library/array.rst:27
+msgid "\\(2)"
+msgstr ""
+
 #: ../../library/array.rst:29
 msgid "``'h'``"
 msgstr "``'h'``"
@@ -230,7 +234,7 @@ msgstr ""
 msgid "Please migrate to ``'w'`` typecode."
 msgstr ""
 
-#: ../../library/array.rst:64
+#: ../../library/array.rst:67
 msgid ""
 "The actual representation of values is determined by the machine "
 "architecture (strictly speaking, by the C implementation).  The actual size "
@@ -239,30 +243,30 @@ msgstr ""
 "實際上數值的表示方法是被機器的架構所決定（更精準地說，被 C 的實作方法決定）。"
 "實際的大小可以透過 :attr:`array.itemsize` 屬性存取。"
 
-#: ../../library/array.rst:68
+#: ../../library/array.rst:71
 msgid "The module defines the following item:"
 msgstr "這個模組定義了以下項目："
 
-#: ../../library/array.rst:73
+#: ../../library/array.rst:76
 msgid "A string with all available type codes."
 msgstr "一個包含所有可用的 type codes 的字串。"
 
-#: ../../library/array.rst:76
+#: ../../library/array.rst:79
 msgid "The module defines the following type:"
 msgstr "這個模組定義了下方的型別："
 
-#: ../../library/array.rst:81
+#: ../../library/array.rst:84
 msgid ""
 "A new array whose items are restricted by *typecode*, and initialized from "
-"the optional *initializer* value, which must be a :class:`bytes` "
-"or :class:`bytearray` object, a Unicode string, or iterable over elements of "
-"the appropriate type."
+"the optional *initializer* value, which must be a :class:`bytes` or :class:"
+"`bytearray` object, a Unicode string, or iterable over elements of the "
+"appropriate type."
 msgstr ""
 "一個新的陣列中的元素被 *typecode* 限制，並由選用的 *initializer* 參數初始化，"
 "*initializer* 必須是一個 :class:`bytes` 或 :class:`bytearray` 物件、一個 "
 "Unicode 字串或包含適當型別元素的可疊代物件 (iterable)。"
 
-#: ../../library/array.rst:86
+#: ../../library/array.rst:89
 msgid ""
 "If given a :class:`bytes` or :class:`bytearray` object, the initializer is "
 "passed to the new array's :meth:`frombytes` method; if given a Unicode "
@@ -275,7 +279,7 @@ msgstr ""
 "方法；其他情況時， 一個 initializer 的可疊代物件將被傳入 :meth:`extend` 方法"
 "之中來將初始項目新增至陣列。"
 
-#: ../../library/array.rst:93
+#: ../../library/array.rst:96
 msgid ""
 "Array objects support the ordinary sequence operations of indexing, slicing, "
 "concatenation, and multiplication.  When using slice assignment, the "
@@ -290,27 +294,27 @@ msgstr ""
 "了緩衝區介面，可以在任何支援 :term:`bytes-like objects <bytes-like object>` "
 "的地方使用。"
 
-#: ../../library/array.rst:99
+#: ../../library/array.rst:102
 msgid ""
 "Raises an :ref:`auditing event <auditing>` ``array.__new__`` with arguments "
 "``typecode``, ``initializer``."
 msgstr ""
 "引發\\ :ref:`稽核事件 (auditing event) <auditing>` ``array.__new__`` 並附帶引"
 "數 ``typecode``、``initializer``。"
 
-#: ../../library/array.rst:104
+#: ../../library/array.rst:107
 msgid "The typecode character used to create the array."
 msgstr "typecode 字元被用在建立陣列時。"
 
-#: ../../library/array.rst:109
+#: ../../library/array.rst:112
 msgid "The length in bytes of one array item in the internal representation."
 msgstr "陣列當中的一個元素在內部需要的位元組長度。"
 
-#: ../../library/array.rst:114
+#: ../../library/array.rst:117
 msgid "Append a new item with value *x* to the end of the array."
 msgstr "新增一個元素 *x* 到陣列的最尾端。"
 
-#: ../../library/array.rst:119
+#: ../../library/array.rst:122
 msgid ""
 "Return a tuple ``(address, length)`` giving the current memory address and "
 "the length in elements of the buffer used to hold array's contents.  The "
@@ -327,7 +331,7 @@ msgstr ""
 "用，例如 :c:func:`!ioctl` 指令。只要陣列存在且沒有使用任何更改長度的操作時，"
 "回傳的數值就有效。"
 
-#: ../../library/array.rst:129
+#: ../../library/array.rst:132
 msgid ""
 "When using array objects from code written in C or C++ (the only way to "
 "effectively make use of this information), it makes more sense to use the "
@@ -339,100 +343,99 @@ msgstr ""
 "適當的做法是使用陣列物件支援的緩衝區介面。這個方法維護了向後兼容性，並應該在"
 "新的程式碼中避免。關於緩衝區介面的文件在\\ :ref:`bufferobjects`。"
 
-#: ../../library/array.rst:138
+#: ../../library/array.rst:141
 msgid ""
 "\"Byteswap\" all items of the array.  This is only supported for values "
-"which are 1, 2, 4, or 8 bytes in size; for other types of "
-"values, :exc:`RuntimeError` is raised.  It is useful when reading data from "
-"a file written on a machine with a different byte order."
+"which are 1, 2, 4, or 8 bytes in size; for other types of values, :exc:"
+"`RuntimeError` is raised.  It is useful when reading data from a file "
+"written on a machine with a different byte order."
 msgstr ""
 "\"Byteswap\" 所有陣列中的物件。這只有支援物件長度為 1、2、4 或 8 位元組的陣"
 "列，其他型別的值會導致 :exc:`RuntimeError`。這在從機器讀取位元順序不同的檔案"
 "時很有用。"
 
-#: ../../library/array.rst:146
+#: ../../library/array.rst:149
 msgid "Return the number of occurrences of *x* in the array."
 msgstr "回傳 *x* 在陣列中出現了幾次。"
 
-#: ../../library/array.rst:151
+#: ../../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* 不是一"
 "個陣列，它必須可以被疊代 (iterable) 且其中的元素必須是可以被加入陣列中的正確"
 "型別。"
 
-#: ../../library/array.rst:159
+#: ../../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` 方法讀出的資料）。"
 
-#: ../../library/array.rst:163
+#: ../../library/array.rst:166
 msgid ":meth:`!fromstring` is renamed to :meth:`frombytes` for clarity."
 msgstr "將 :meth:`!fromstring` 更名為 :meth:`frombytes`，使其更加清晰易懂。"
 
-#: ../../library/array.rst:169
+#: ../../library/array.rst:172
 msgid ""
 "Read *n* items (as machine values) from the :term:`file object` *f* and "
-"append them to the end of the array.  If less than *n* items are "
-"available, :exc:`EOFError` is raised, but the items that were available are "
-"still inserted into the array."
+"append them to the end of the array.  If less than *n* items are available, :"
+"exc:`EOFError` is raised, but the items that were available are still "
+"inserted into the array."
 msgstr ""
 "從 :term:`file object` *f* 讀取 *n* 個元素（作為機器數值），接著將這些元素加"
 "入陣列的最尾端。如果只有少於 *n* 個有效的元素會導致 :exc:`EOFError`，但有效的"
 "元素仍然會被加入陣列中。"
 
-#: ../../library/array.rst:177
+#: ../../library/array.rst:180
 msgid ""
-"Append items from the list.  This is equivalent to ``for x in list: "
-"a.append(x)`` except that if there is a type error, the array is unchanged."
+"Append items from the list.  This is equivalent to ``for x in list: a."
+"append(x)`` except that if there is a type error, the array is unchanged."
 msgstr ""
 "從 list 中新增元素。這等價於 ``for x in list: a.append(x)``，除了有型別錯誤產"
 "生時，陣列會保持原狀不會被更改。"
 
-#: ../../library/array.rst:183
+#: ../../library/array.rst:186
 msgid ""
 "Extends this array with data from the given Unicode string. The array must "
 "have type code ``'u'`` or ``'w'``; otherwise a :exc:`ValueError` is raised. "
 "Use ``array.frombytes(unicodestring.encode(enc))`` to append Unicode data to "
 "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:191
+#: ../../library/array.rst:194
 msgid ""
 "Return the smallest *i* such that *i* is the index of the first occurrence "
 "of *x* in the array.  The optional arguments *start* and *stop* can be "
-"specified to search for *x* within a subsection of the array.  "
-"Raise :exc:`ValueError` if *x* is not found."
+"specified to search for *x* within a subsection of the array.  Raise :exc:"
+"`ValueError` if *x* is not found."
 msgstr ""
 "回傳 *i* 的最小數值，使得 *i* 成為陣列之中第一次出現 *x* 的索引。選擇性的引"
 "數 *start* 及 *stop* 則可以被用來在指定的陣列空間中搜尋 *x*。如果 *x* 不存在"
 "將導致 :exc:`ValueError`。"
 
-#: ../../library/array.rst:196
+#: ../../library/array.rst:199
 msgid "Added optional *start* and *stop* parameters."
 msgstr "新增選擇性的參數 *start* 及 *stop*。"
 
-#: ../../library/array.rst:202
+#: ../../library/array.rst:205
 msgid ""
 "Insert a new item with value *x* in the array before position *i*. Negative "
 "values are treated as being relative to the end of the array."
 msgstr "在位置 *i* 之前插入一個元素 *x*。負數的索引值會從陣列尾端開始數。"
 
-#: ../../library/array.rst:208
+#: ../../library/array.rst:211
 msgid ""
 "Removes the item with the index *i* from the array and returns it. The "
 "optional argument defaults to ``-1``, so that by default the last item is "
@@ -441,20 +444,20 @@ msgstr ""
 "移除並回傳陣列索引值 *i* 的元素。選擇性的引數 *i* 預設為 ``-1``，所以預設會刪"
 "除並回傳最後一個元素。"
 
-#: ../../library/array.rst:215
+#: ../../library/array.rst:218
 msgid "Remove the first occurrence of *x* from the array."
 msgstr "從陣列中刪除第一個出現的 *x*。"
 
-#: ../../library/array.rst:220
+#: ../../library/array.rst:223
 #, fuzzy
 msgid "Remove all elements from the array."
 msgstr "從陣列中刪除第一個出現的 *x*。"
 
-#: ../../library/array.rst:227
+#: ../../library/array.rst:230
 msgid "Reverse the order of the items in the array."
 msgstr "反轉陣列中元素的順序。"
 
-#: ../../library/array.rst:232
+#: ../../library/array.rst:235
 msgid ""
 "Convert the array to an array of machine values and return the bytes "
 "representation (the same sequence of bytes that would be written to a file "
@@ -463,31 +466,30 @@ msgstr ""
 "將陣列轉為另一個機器數值組成的陣列並回傳它的位元組表示（跟用 :meth:`tofile` "
 "方法寫入檔案時的位元序列相同）。"
 
-#: ../../library/array.rst:236
+#: ../../library/array.rst:239
 msgid ":meth:`!tostring` is renamed to :meth:`tobytes` for clarity."
 msgstr "為了明確性，過去的 :meth:`!tostring` 已更名為 :meth:`tobytes`。"
 
-#: ../../library/array.rst:242
+#: ../../library/array.rst:245
 msgid "Write all items (as machine values) to the :term:`file object` *f*."
 msgstr "將所有元素（作為機器數值）寫入 :term:`file object` *f*。"
 
-#: ../../library/array.rst:247
+#: ../../library/array.rst:250
 msgid "Convert the array to an ordinary list with the same items."
 msgstr "不更改元素，將陣列轉為一般的 list。"
 
-#: ../../library/array.rst:252
+#: ../../library/array.rst:255
 #, fuzzy
 msgid ""
 "Convert the array to a Unicode string.  The array must have a type ``'u'`` "
-"or ``'w'``; otherwise a :exc:`ValueError` is raised. Use "
-"``array.tobytes().decode(enc)`` to obtain a Unicode string from an array of "
-"some other type."
+"or ``'w'``; otherwise a :exc:`ValueError` is raised. Use ``array.tobytes()."
+"decode(enc)`` to obtain a Unicode string from an array of some other type."
 msgstr ""
-"將陣列轉為一個 Unicode 字串。陣列的型別必須為 ``u``。其他型別的陣列會導"
-"致 :exc:`ValueError` 錯誤。請使用 ``array.tobytes().decode(enc)`` 來為其他型"
-"別的陣列轉為 Unicode 字串。"
+"將陣列轉為一個 Unicode 字串。陣列的型別必須為 ``u``。其他型別的陣列會導致 :"
+"exc:`ValueError` 錯誤。請使用 ``array.tobytes().decode(enc)`` 來為其他型別的"
+"陣列轉為 Unicode 字串。"
 
-#: ../../library/array.rst:257
+#: ../../library/array.rst:260
 #, fuzzy
 msgid ""
 "The string representation of array objects has the form ``array(typecode, "
@@ -503,10 +505,10 @@ msgstr ""
 "陣列物件的字串表示形式為 ``array(typecode, initializer)``。若為空陣列則參數 "
 "*initializer* 被省略，若 *typecode* 是 ``'u'`` 將被表示為 Unicode 字串，其他"
 "情況則被表示為由數字組成的 list。只要 :class:`~array.array` class（類別）透"
-"過 ``from array import array`` 的方式引入，便能確保該字串表示能透"
-"過 :func:`eval` 轉換回一個擁有相同型別及數值的陣列。範例： ::"
+"過 ``from array import array`` 的方式引入，便能確保該字串表示能透過 :func:"
+"`eval` 轉換回一個擁有相同型別及數值的陣列。範例： ::"
 
-#: ../../library/array.rst:269
+#: ../../library/array.rst:272
 #, fuzzy
 msgid ""
 "array('l')\n"
@@ -519,19 +521,19 @@ msgstr ""
 "array('l', [1, 2, 3, 4, 5])\n"
 "array('d', [1.0, 2.0, 3.14, -inf, nan])"
 
-#: ../../library/array.rst:277
+#: ../../library/array.rst:280
 msgid "Module :mod:`struct`"
 msgstr ":mod:`struct` 模組"
 
-#: ../../library/array.rst:278
+#: ../../library/array.rst:281
 msgid "Packing and unpacking of heterogeneous binary data."
 msgstr "將包含不同資料類型的二進位資料包裝與解開包裝。"
 
-#: ../../library/array.rst:280
+#: ../../library/array.rst:283
 msgid "`NumPy <https://numpy.org/>`_"
 msgstr "`NumPy <https://numpy.org/>`_"
 
-#: ../../library/array.rst:281
+#: ../../library/array.rst:284
 msgid "The NumPy package defines another array type."
 msgstr "NumPy 套件定義了另一個陣列型別"
 
