sync with cpython d6375c3d

Author: github-actions[bot]

c-api/bytearray.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-03-28 00:21+0000\n"
+"POT-Creation-Date: 2026-09-16 00:19+0000\n"
 "PO-Revision-Date: 2023-08-12 11:42+0800\n"
 "Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -27,109 +27,117 @@ msgid ""
 "This subtype of :c:type:`PyObject` represents a Python bytearray object."
 msgstr "這個 :c:type:`PyObject` 的子型別代表了 Python 的位元組陣列物件。"
 
-#: ../../c-api/bytearray.rst:18
+#: ../../c-api/bytearray.rst:17
+msgid ""
+"The internal buffer of :c:type:`PyByteArrayObject` always includes an extra "
+"trailing null byte for compatibility with null terminated C strings.  This "
+"extra byte is not counted in :c:func:`PyByteArray_Size` nor in the *len* "
+"arguments of the functions below."
+msgstr ""
+
+#: ../../c-api/bytearray.rst:24
 msgid ""
 "This instance of :c:type:`PyTypeObject` represents the Python bytearray "
 "type; it is the same object as :class:`bytearray` in the Python layer."
 msgstr ""
 "這個 :c:type:`PyTypeObject` 的實例代表了 Python 的位元組陣列型別；在 Python "
 "層中的 :class:`bytearray` 為同一個物件。"
 
-#: ../../c-api/bytearray.rst:23
+#: ../../c-api/bytearray.rst:29
 msgid "Type check macros"
 msgstr "型別檢查巨集"
 
-#: ../../c-api/bytearray.rst:27
+#: ../../c-api/bytearray.rst:33
 msgid ""
 "Return true if the object *o* is a bytearray object or an instance of a "
 "subtype of the bytearray type.  This function always succeeds."
 msgstr ""
 "如果物件 *o* 是一個位元組陣列物件，或者是位元組陣列型別的子型別的實例，則回傳"
 "真值。此函式總是會成功執行。"
 
-#: ../../c-api/bytearray.rst:33
+#: ../../c-api/bytearray.rst:39
 msgid ""
 "Return true if the object *o* is a bytearray object, but not an instance of "
 "a subtype of the bytearray type.  This function always succeeds."
 msgstr ""
 "如果物件 *o* 是一個位元組陣列物件，但不是位元組陣列型別的子型別的實例，則回傳"
 "真值。此函式總是會成功執行。"
 
-#: ../../c-api/bytearray.rst:38
+#: ../../c-api/bytearray.rst:44
 msgid "Direct API functions"
 msgstr "直接 API 函式"
 
-#: ../../c-api/bytearray.rst:42
+#: ../../c-api/bytearray.rst:48
 msgid ""
 "Return a new bytearray object from any object, *o*, that implements the :ref:"
 "`buffer protocol <bufferobjects>`."
 msgstr ""
 "由任意物件 *o* 回傳一個新的位元組陣列物件，並實作了\\ :ref:`緩衝協定 (buffer "
 "protocol) <bufferobjects>`。"
 
-#: ../../c-api/bytearray.rst:45 ../../c-api/bytearray.rst:56
-#: ../../c-api/bytearray.rst:63
+#: ../../c-api/bytearray.rst:51 ../../c-api/bytearray.rst:62
+#: ../../c-api/bytearray.rst:69
 msgid "On failure, return ``NULL`` with an exception set."
 msgstr "在失敗時，會回傳 ``NULL`` 並設定例外。"
 
-#: ../../c-api/bytearray.rst:48 ../../c-api/bytearray.rst:66
+#: ../../c-api/bytearray.rst:54 ../../c-api/bytearray.rst:72
 msgid ""
 "If the object implements the buffer protocol, then the buffer must not be "
 "mutated while the bytearray object is being created."
 msgstr ""
 
-#: ../../c-api/bytearray.rst:54
+#: ../../c-api/bytearray.rst:60
 msgid "Create a new bytearray object from *string* and its length, *len*."
 msgstr "從 *string* 及其長度 *len* 建立一個新的位元組陣列物件。"
 
-#: ../../c-api/bytearray.rst:61
+#: ../../c-api/bytearray.rst:67
 msgid ""
 "Concat bytearrays *a* and *b* and return a new bytearray with the result."
 msgstr "連接位元組陣列 *a* 和 *b*，並回傳一個包含結果的新位元組陣列。"
 
-#: ../../c-api/bytearray.rst:72
+#: ../../c-api/bytearray.rst:78
 msgid "Return the size of *bytearray* after checking for a ``NULL`` pointer."
 msgstr "在檢查為 ``NULL`` 指標後，回傳 *bytearray* 的大小。"
 
-#: ../../c-api/bytearray.rst:77
+#: ../../c-api/bytearray.rst:83
 msgid ""
 "Return the contents of *bytearray* as a char array after checking for a "
 "``NULL`` pointer.  The returned array always has an extra null byte appended."
 msgstr ""
 "在檢查是否為 ``NULL`` 指標後，將 *bytearray* 的內容回傳為字元陣列。回傳的陣列"
 "總是會多附加一個空位元組。"
 
-#: ../../c-api/bytearray.rst:82 ../../c-api/bytearray.rst:104
+#: ../../c-api/bytearray.rst:88 ../../c-api/bytearray.rst:110
 msgid ""
 "It is not thread-safe to mutate the bytearray object while using the "
 "returned char array."
 msgstr ""
 
-#: ../../c-api/bytearray.rst:87
+#: ../../c-api/bytearray.rst:93
 msgid ""
 "Resize the internal buffer of *bytearray* to *len*. Failure is a ``-1`` "
 "return with an exception set."
 msgstr ""
 "將 *bytearray* 的內部緩衝區大小調整為 *len*。失敗時會回傳 ``-1`` 並設定例外。"
 
-#: ../../c-api/bytearray.rst:90
+#: ../../c-api/bytearray.rst:96
 msgid ""
 "A negative *len* will now result in an exception being set and -1 returned."
 msgstr "負的 *len* 現在會設定例外並回傳 -1。"
 
-#: ../../c-api/bytearray.rst:95
+#: ../../c-api/bytearray.rst:101
 msgid "Macros"
 msgstr "巨集"
 
-#: ../../c-api/bytearray.rst:97
+#: ../../c-api/bytearray.rst:103
 msgid "These macros trade safety for speed and they don't check pointers."
 msgstr "這些巨集犧牲了安全性以換取速度，並且它們不會檢查指標。"
 
-#: ../../c-api/bytearray.rst:101
+#: ../../c-api/bytearray.rst:107
 msgid "Similar to :c:func:`PyByteArray_AsString`, but without error checking."
 msgstr "與 :c:func:`PyByteArray_AsString` 類似，但沒有錯誤檢查。"
 
-#: ../../c-api/bytearray.rst:109
+#: ../../c-api/bytearray.rst:115
 msgid "Similar to :c:func:`PyByteArray_Size`, but without error checking."
 msgstr "與 :c:func:`PyByteArray_Size` 類似，但沒有錯誤檢查。"