Fixing the translate

Author: Yorkxe

c-api/tuple.po

@@ -3,7 +3,7 @@
 #
 # Translators:
 # Leon H., 2017
-#Yorkxe <karta25768@gmail.com>, 2025
+# Yorkxe <karta25768@gmail.com>, 2025
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
@@ -31,20 +31,24 @@ msgstr "此 :c:type:`PyObject` 子型別代表 Python 元組物件"
 msgid ""
 "This instance of :c:type:`PyTypeObject` represents the Python tuple type; it "
 "is the same object as :class:`tuple` in the Python layer."
-msgstr "此 :c:type:`PyTypeObject` 實例代表 Python 元組型別，與 Python 層中的"
-" :class:`tuple` 是同一物件"
+msgstr ""
+"此 :c:type:`PyTypeObject` 實例代表 Python 元組型別，與 Python 層中的 :class:"
+"`tuple` 是同一物件"
 
 #: ../../c-api/tuple.rst:24
 msgid ""
 "Return true if *p* is a tuple object or an instance of a subtype of the "
 "tuple type.  This function always succeeds."
-msgstr "如果 *p* 為一元組物件或是元組型別的子型別實例時回傳 true。此函式總會執行成功"
+msgstr ""
+"如果 *p* 為一元組物件或是元組型別的子型別實例時回傳 true。此函式總會執行成功"
 
 #: ../../c-api/tuple.rst:30
 msgid ""
 "Return true if *p* is a tuple object, but not an instance of a subtype of "
 "the tuple type.  This function always succeeds."
-msgstr "如果 *p* 為一元組物件但不是元組型別的子型別實例時回傳 true。此函式總會執行成功"
+msgstr ""
+"如果 *p* 為一元組物件但不是元組型別的子型別實例時回傳 true。此函式總會執行成"
+"功"
 
 #: ../../c-api/tuple.rst:36
 msgid ""
@@ -58,16 +62,18 @@ msgid ""
 "failure. The tuple values are initialized to the subsequent *n* C arguments "
 "pointing to Python objects. ``PyTuple_Pack(2, a, b)`` is equivalent to "
 "``Py_BuildValue(\"(OO)\", a, b)``."
-msgstr "回傳一個長度為 *n* 的新元組物件，失敗時會回傳 ``NULL`` 並設定例外。元組值被"
-"初始化為指向 Python 物件的接續 *n* 個 C 引數。``PyTuple_Pack(2, a, b)`` 等價於 "
+msgstr ""
+"回傳一個長度為 *n* 的新元組物件，失敗時會回傳 ``NULL`` 並設定例外。元組值被初"
+"始化為指向 Python 物件的接續 *n* 個 C 引數。``PyTuple_Pack(2, a, b)`` 等價於 "
 "``Py_BuildValue(\"(OO)\", a, b)``。"
 
 #: ../../c-api/tuple.rst:50
 msgid ""
 "Take a pointer to a tuple object, and return the size of that tuple. On "
 "error, return ``-1`` with an exception set."
-msgstr "拿取一個元組物件的指標，然後回傳此元組的大小。錯誤發生時，回傳 ``-1`` "
-"並設定例外。"
+msgstr ""
+"拿取一個元組物件的指標，然後回傳此元組的大小。錯誤發生時，回傳 ``-1`` 並設定"
+"例外。"
 
 #: ../../c-api/tuple.rst:56
 msgid "Like :c:func:`PyTuple_Size`, but without error checking."
@@ -76,20 +82,23 @@ msgstr "就像 :c:func:`PyTuple_Size` 但沒有錯誤檢查。"
 #: ../../c-api/tuple.rst:61
 msgid ""
 "Return the object at position *pos* in the tuple pointed to by *p*.  If "
-"*pos* is negative or out of bounds, return ``NULL`` and set "
-"an :exc:`IndexError` exception."
-msgstr "回傳 *p* 指向的元組中位置 *pos* 處的物件。如果 *pos* 為負數或超出範圍，回傳"
-" ``NULL`` 並設定 :exc:`IndexError` 例外。"
+"*pos* is negative or out of bounds, return ``NULL`` and set an :exc:"
+"`IndexError` exception."
+msgstr ""
+"回傳 *p* 指向的元組中位置 *pos* 處的物件。如果 *pos* 為負數或超出範圍，回傳 "
+"``NULL`` 並設定 :exc:`IndexError` 例外。"
 
 #: ../../c-api/tuple.rst:64
 msgid ""
 "The returned reference is borrowed from the tuple *p* (that is: it is only "
 "valid as long as you hold a reference to *p*). To get a :term:`strong "
-"reference`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) <Py_NewRef>` "
-"or :c:func:`PySequence_GetItem`."
-msgstr "回傳的參照借自元組 *p*\\ （也就是說：它僅在你持有 *p* 的參照時有效）。"
-"若要取得一個 :term:`strong reference`，請使用 :c:func:`Py_NewRef(PyTuple_GetItem(...)) "
-"<Py_NewRef>` 或 :c:func:`PySequence_GetItem`。"
+"reference`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) <Py_NewRef>` or :c:"
+"func:`PySequence_GetItem`."
+msgstr ""
+"回傳的參照借自元組 *p*\\ （也就是說：它僅在你持有 *p* 的參照時有效）。若要取"
+"得一個 :term:`strong reference`，請使用 :c:func:"
+"`Py_NewRef(PyTuple_GetItem(...)) <Py_NewRef>` 或 :c:func:"
+"`PySequence_GetItem`。"
 
 #: ../../c-api/tuple.rst:73
 msgid "Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments."
@@ -99,8 +108,9 @@ msgstr "與 :c:func:`PyTuple_GetItem` 相似，但不檢查其引數。"
 msgid ""
 "Return the slice of the tuple pointed to by *p* between *low* and *high*, or "
 "``NULL`` with an exception set on failure."
-msgstr "回傳由 *p* 指向的元組中介於 *low* 和 *high* 之間的切片或在錯誤時回傳  ``NULL``"
-" 並設定例外。"
+msgstr ""
+"回傳由 *p* 指向的元組中介於 *low* 和 *high* 之間的切片或在錯誤時回傳  "
+"``NULL`` 並設定例外。"
 
 #: ../../c-api/tuple.rst:81
 msgid ""
@@ -113,8 +123,9 @@ msgid ""
 "Insert a reference to object *o* at position *pos* of the tuple pointed to "
 "by *p*.  Return ``0`` on success.  If *pos* is out of bounds, return ``-1`` "
 "and set an :exc:`IndexError` exception."
-msgstr "於 *p* 指向的元組 *pos* 位置處插入對物件 *o* 的參照。成功時回傳 ``0``，"
-"如果 *pos* 超出邊界則回傳 ``-1``，並設定 :exc:`IndexError` 例外。"
+msgstr ""
+"於 *p* 指向的元組 *pos* 位置處插入對物件 *o* 的參照。成功時回傳 ``0``，如果 "
+"*pos* 超出邊界則回傳 ``-1``，並設定 :exc:`IndexError` 例外。"
 
 #: ../../c-api/tuple.rst:93
 msgid ""
@@ -126,33 +137,35 @@ msgstr "此函式 \"竊取\" 對 *o* 的參照，並丟棄對元組中受影響
 msgid ""
 "Like :c:func:`PyTuple_SetItem`, but does no error checking, and should "
 "*only* be used to fill in brand new tuples."
-msgstr "與 :c:func:`PyTuple_SetItem` 相似，但不進行錯誤檢查，且應 *只* "
-"用於填充全新的元組。"
+msgstr ""
+"與 :c:func:`PyTuple_SetItem` 相似，但不進行錯誤檢查，且應 *只* 用於填充全新的"
+"元組。"
 
 #: ../../c-api/tuple.rst:102 ../../c-api/tuple.rst:224
 #: ../../c-api/tuple.rst:242
 msgid ""
-"Bounds checking is performed as an assertion if Python is built "
-"in :ref:`debug mode <debug-build>` or :option:`with assertions <--with-"
-"assertions>`."
-msgstr "若 Python 以 :ref:`debug mode <debug-build>` 或 :option:`with assertions"
-" <--with-assertions>` 建置，則會進行作為斷言（asserting）的邊界檢查。"
+"Bounds checking is performed as an assertion if Python is built in :ref:"
+"`debug mode <debug-build>` or :option:`with assertions <--with-assertions>`."
+msgstr ""
+"若 Python 以 :ref:`debug mode <debug-build>` 或 :option:`with assertions <--"
+"with-assertions>` 建置，則會進行作為斷言（asserting）的邊界檢查。"
 
 #: ../../c-api/tuple.rst:107
 msgid ""
-"This function \"steals\" a reference to *o*, and, "
-"unlike :c:func:`PyTuple_SetItem`, does *not* discard a reference to any item "
-"that is being replaced; any reference in the tuple at position *pos* will be "
-"leaked."
-msgstr "此函式 \"竊取\" 對 *o* 的參照，且與 :c:func:`PyTuple_SetItem` 不同的是，"
-"此函式並 *不* 丟棄任何被替代項目的參照；元組中 *pos* 位置的所有參照皆會被洩漏。"
+"This function \"steals\" a reference to *o*, and, unlike :c:func:"
+"`PyTuple_SetItem`, does *not* discard a reference to any item that is being "
+"replaced; any reference in the tuple at position *pos* will be leaked."
+msgstr ""
+"此函式 \"竊取\" 對 *o* 的參照，且與 :c:func:`PyTuple_SetItem` 不同的是，此函"
+"式並 *不* 丟棄任何被替代項目的參照；元組中 *pos* 位置的所有參照皆會被洩漏。"
 
 #: ../../c-api/tuple.rst:114
 msgid ""
 "This macro should *only* be used on tuples that are newly created. Using "
 "this macro on a tuple that is already in use (or in other words, has a "
 "refcount > 1) could lead to undefined behavior."
-msgstr "此巨集應 *僅* 用於新建立的元組。在正被使用中的元組（或換句話說，參照計數大於 "
+msgstr ""
+"此巨集應 *僅* 用於新建立的元組。在正被使用中的元組（或換句話說，參照計數大於 "
 "1 的元組）上使用此巨集可能會導致未定義行為。"
 
 #: ../../c-api/tuple.rst:121
@@ -166,35 +179,40 @@ msgid ""
 "Client code should never assume that the resulting value of ``*p`` will be "
 "the same as before calling this function. If the object referenced by ``*p`` "
 "is replaced, the original ``*p`` is destroyed.  On failure, returns ``-1`` "
-"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` "
-"or :exc:`SystemError`."
-msgstr "可用於調整元組的大小。*newsize* 將是元組的新長度。由於元組 *應該* 是不可變的，"
-"因此僅當物件只有一個參照時才應使用此方法。如果程式碼的其他部分已經知道該元組，則 "
-"*不要* 使用此方法。最終元組總會變大或縮小。可以將其理解為銷毀舊元組並建立一個新元組，"
-"只是有著更高的效率。成功時回傳 ``0``。用戶端程式碼絕不應假設 ``*p`` 的結果值與呼叫此函數"
-"之前的值相同。如果 ``*p`` 參照的物件被替換，則原始的 ``*p`` 將被銷毀。失敗時，回傳 ``-1``，"
-"並將 ``*p`` 設定為 ``NULL``，並引發 :exc:`MemoryError` 或 :exc:`SystemError` 例外。"
+"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` or :exc:"
+"`SystemError`."
+msgstr ""
+"可用於調整元組的大小。*newsize* 將是元組的新長度。由於元組 *應該* 是不可變"
+"的，因此僅當物件只有一個參照時才應使用此方法。如果程式碼的其他部分已經知道該"
+"元組，則 *不要* 使用此方法。最終元組總會變大或縮小。可以將其理解為銷毀舊元組"
+"並建立一個新元組，只是有著更高的效率。成功時回傳 ``0``。用戶端程式碼絕不應假"
+"設 ``*p`` 的結果值與呼叫此函數之前的值相同。如果 ``*p`` 參照的物件被替換，則"
+"原始的 ``*p`` 將被銷毀。失敗時，回傳 ``-1``，並將 ``*p`` 設定為 ``NULL``，並"
+"引發 :exc:`MemoryError` 或 :exc:`SystemError` 例外。"
 
 #: ../../c-api/tuple.rst:136
 msgid "Struct Sequence Objects"
 msgstr "結構序列物件"
 
 #: ../../c-api/tuple.rst:138
 msgid ""
-"Struct sequence objects are the C equivalent "
-"of :func:`~collections.namedtuple` objects, i.e. a sequence whose items can "
-"also be accessed through attributes. To create a struct sequence, you first "
-"have to create a specific struct sequence type."
-msgstr "結構序列物件是 :func:`~collections.namedtuple` 物件在 C 語言中的等價，換言之，"
-"一個序列的元素也可以透過屬性存取。要建立結構序列，首先需要建立特定的結構序列型別。"
+"Struct sequence objects are the C equivalent of :func:`~collections."
+"namedtuple` objects, i.e. a sequence whose items can also be accessed "
+"through attributes. To create a struct sequence, you first have to create a "
+"specific struct sequence type."
+msgstr ""
+"結構序列物件是 :func:`~collections.namedtuple` 物件在 C 語言中的等價，換言"
+"之，一個序列的元素也可以透過屬性存取。要建立結構序列，首先需要建立特定的結構"
+"序列型別。"
 
 #: ../../c-api/tuple.rst:145
 msgid ""
 "Create a new struct sequence type from the data in *desc*, described below. "
-"Instances of the resulting type can be created "
-"with :c:func:`PyStructSequence_New`."
-msgstr "從 *desc* 中的資料建立一個新的結構序列型別，如下所述。可以使用 "
-":c:func:`PyStructSequence_New` 以建立產生結構序列型別的實例。"
+"Instances of the resulting type can be created with :c:func:"
+"`PyStructSequence_New`."
+msgstr ""
+"從 *desc* 中的資料建立一個新的結構序列型別，如下所述。可以使用 :c:func:"
+"`PyStructSequence_New` 以建立產生結構序列型別的實例。"
 
 #: ../../c-api/tuple.rst:148 ../../c-api/tuple.rst:217
 msgid "Return ``NULL`` with an exception set on failure."
@@ -208,8 +226,9 @@ msgstr "從 *desc* 原地（in place）初始化結構序列型別 *type*。"
 msgid ""
 "Like :c:func:`PyStructSequence_InitType`, but returns ``0`` on success and "
 "``-1`` with an exception set on failure."
-msgstr "與 :c:func:`PyStructSequence_InitType` 相似，但運行成功時回傳 ``0``，"
-"運行失敗時回傳 ``-1`` 並設定例外。"
+msgstr ""
+"與 :c:func:`PyStructSequence_InitType` 相似，但運行成功時回傳 ``0``，運行失敗"
+"時回傳 ``-1`` 並設定例外。"
 
 #: ../../c-api/tuple.rst:166
 msgid "Contains the meta information of a struct sequence type to create."
@@ -219,8 +238,9 @@ msgstr "包含要建立的結構序列化型別的中介資訊（meta informatio
 msgid ""
 "Fully qualified name of the type; null-terminated UTF-8 encoded. The name "
 "must contain the module name."
-msgstr "型別的完整限定名稱（Fully qualified name）；以 UTF-8 編碼並以空字元結尾。"
-"名稱必須包含完整的模組名稱。"
+msgstr ""
+"型別的完整限定名稱（Fully qualified name）；以 UTF-8 編碼並以空字元結尾。名稱"
+"必須包含完整的模組名稱。"
 
 #: ../../c-api/tuple.rst:175
 msgid "Pointer to docstring for the type or ``NULL`` to omit."
@@ -237,20 +257,23 @@ msgstr "Python 端可以看到欄位的數目（如果作為元組使用）。"
 #: ../../c-api/tuple.rst:188
 msgid ""
 "Describes a field of a struct sequence. As a struct sequence is modeled as a "
-"tuple, all fields are typed as :c:expr:`PyObject*`.  The index in "
-"the :c:member:`~PyStructSequence_Desc.fields` array of "
-"the :c:type:`PyStructSequence_Desc` determines which field of the struct "
-"sequence is described."
-msgstr "描述結構序列的一個欄位。由於結構序列以元組作為原型，所有欄位的型別均為 "
-":c:expr:`PyObject*`。:c:type:`PyStructSequence_Desc` 在 "
-":c:member:`~PyStructSequence_Desc.fields` 陣列中的索引決定了描述的是結構序列的哪個欄位。"
+"tuple, all fields are typed as :c:expr:`PyObject*`.  The index in the :c:"
+"member:`~PyStructSequence_Desc.fields` array of the :c:type:"
+"`PyStructSequence_Desc` determines which field of the struct sequence is "
+"described."
+msgstr ""
+"描述結構序列的一個欄位。由於結構序列以元組作為原型，所有欄位的型別均為 :c:"
+"expr:`PyObject*`。:c:type:`PyStructSequence_Desc` 在 :c:member:"
+"`~PyStructSequence_Desc.fields` 陣列中的索引決定了描述的是結構序列的哪個欄"
+"位。"
 
 #: ../../c-api/tuple.rst:196
 msgid ""
-"Name for the field or ``NULL`` to end the list of named fields, set "
-"to :c:data:`PyStructSequence_UnnamedField` to leave unnamed."
-msgstr "欄位名稱，或 ``NULL`` 表示命名欄位串列結束，設定為 "
-":c:data:`PyStructSequence_UnnamedField` 表示該欄位不命名。"
+"Name for the field or ``NULL`` to end the list of named fields, set to :c:"
+"data:`PyStructSequence_UnnamedField` to leave unnamed."
+msgstr ""
+"欄位名稱，或 ``NULL`` 表示命名欄位串列結束，設定為 :c:data:"
+"`PyStructSequence_UnnamedField` 表示該欄位不命名。"
 
 #: ../../c-api/tuple.rst:201
 msgid "Field docstring or ``NULL`` to omit."
@@ -266,8 +289,8 @@ msgstr "型別原本是 ``char *``，現已被修改。"
 
 #: ../../c-api/tuple.rst:214
 msgid ""
-"Creates an instance of *type*, which must have been created "
-"with :c:func:`PyStructSequence_NewType`."
+"Creates an instance of *type*, which must have been created with :c:func:"
+"`PyStructSequence_NewType`."
 msgstr "建立 *type* 的實例，必須以 :c:func:`PyStructSequence_NewType` 建立。"
 
 #: ../../c-api/tuple.rst:222
@@ -288,8 +311,9 @@ msgid ""
 "Sets the field at index *pos* of the struct sequence *p* to value *o*.  "
 "Like :c:func:`PyTuple_SET_ITEM`, this should only be used to fill in brand "
 "new instances."
-msgstr "將結構序列 *p* 中索引 *pos* 處的欄位值設為 *o*。與 "
-":c:func:`PyTuple_SET_ITEM` 類似，此函式僅套用於填充全新實例。"
+msgstr ""
+"將結構序列 *p* 中索引 *pos* 處的欄位值設為 *o*。與 :c:func:"
+"`PyTuple_SET_ITEM` 類似，此函式僅套用於填充全新實例。"
 
 #: ../../c-api/tuple.rst:247
 msgid "This function \"steals\" a reference to *o*."