Merge branch '3.12' into building

bananaiselite · web-flow · commit b9bd29b59f7c · 2023-08-10T01:28:56.000+08:00
diff --git a/c-api/complex.po b/c-api/complex.po
@@ -1,15 +1,15 @@
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2022, Python Software Foundation
+# Copyright (C) 2001-2023, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
+# Matt Wang <mattwang44@gmail.com>, 2023
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-07-29 00:03+0000\n"
 "PO-Revision-Date: 2015-12-09 17:51+0000\n"
-"Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
+"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
@@ -20,7 +20,7 @@ msgstr ""
 
 #: ../../c-api/complex.rst:6
 msgid "Complex Number Objects"
-msgstr ""
+msgstr "複數物件"
 
 #: ../../c-api/complex.rst:10
 msgid ""
@@ -29,17 +29,23 @@ msgid ""
 "and the other is a C structure which represents the actual complex number "
 "value. The API provides functions for working with both."
 msgstr ""
+"從 C API 來看，Python 的複數物件被實作為兩種不同的型別：一種是公開給 Python "
+"程式的 Python 物件，另一種是表示實際複數值的 C 結構。API 提供了與兩者一起作用"
+"的函式。"
 
 #: ../../c-api/complex.rst:17
 msgid "Complex Numbers as C Structures"
-msgstr ""
+msgstr "作為 C 結構的複數"
 
 #: ../../c-api/complex.rst:19
 msgid ""
 "Note that the functions which accept these structures as parameters and "
 "return them as results do so *by value* rather than dereferencing them "
 "through pointers.  This is consistent throughout the API."
 msgstr ""
+"請注意，接受這些結構作為參數並將它們作為結果回傳的函式是\\ *按值 (by "
+"value)* 執行的，而不是透過指標取消參照 (dereference) 它們。這在整個 API 中"
+"都是一致的。"
 
 #: ../../c-api/complex.rst:26
 msgid ""
@@ -48,103 +54,116 @@ msgid ""
 "objects use structures of this type as input or output values, as "
 "appropriate.  It is defined as::"
 msgstr ""
+"相對於 Python 複數物件之數值部分的 C 結構。大多數處理複數物件的函式根據需求會"
+"使用這種型別的結構作為輸入或輸出值。它定義為： ::"
 
 #: ../../c-api/complex.rst:39
 msgid ""
 "Return the sum of two complex numbers, using the C :c:type:`Py_complex` "
 "representation."
-msgstr ""
+msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數之和。"
 
 #: ../../c-api/complex.rst:45
 msgid ""
 "Return the difference between two complex numbers, using the C :c:type:"
 "`Py_complex` representation."
-msgstr ""
+msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數間的差。"
 
 #: ../../c-api/complex.rst:51
 msgid ""
 "Return the negation of the complex number *num*, using the C :c:type:"
 "`Py_complex` representation."
-msgstr ""
+msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳複數 *num* 的相反數 (negation)。"
 
 #: ../../c-api/complex.rst:57
 msgid ""
 "Return the product of two complex numbers, using the C :c:type:`Py_complex` "
 "representation."
-msgstr ""
+msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數的乘積。"
 
 #: ../../c-api/complex.rst:63
 msgid ""
 "Return the quotient of two complex numbers, using the C :c:type:`Py_complex` "
 "representation."
-msgstr ""
+msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數的商。"
 
 #: ../../c-api/complex.rst:66
 msgid ""
 "If *divisor* is null, this method returns zero and sets :c:data:`errno` to :"
 "c:macro:`!EDOM`."
 msgstr ""
+"如果 *divisor* 為 null，則此方法會回傳零並將 :c:data:`errno` 設定為 :c:macro:"
+"`!EDOM`。"
 
 #: ../../c-api/complex.rst:72
 msgid ""
 "Return the exponentiation of *num* by *exp*, using the C :c:type:"
 "`Py_complex` representation."
 msgstr ""
+"以 C 的 :c:type:`Py_complex` 表示形式來回傳 *num* 的 *exp* 次方的結果。"
 
 #: ../../c-api/complex.rst:75
 msgid ""
 "If *num* is null and *exp* is not a positive real number, this method "
 "returns zero and sets :c:data:`errno` to :c:macro:`!EDOM`."
 msgstr ""
+"如果 *num* 為 null 且 *exp* 不是正實數，則此方法會回傳零並將 :c:data:`errno` "
+"設定為 :c:macro:`!EDOM`。"
 
 #: ../../c-api/complex.rst:80
 msgid "Complex Numbers as Python Objects"
-msgstr ""
+msgstr "作為 Python 物件的複數"
 
 #: ../../c-api/complex.rst:85
 msgid ""
 "This subtype of :c:type:`PyObject` represents a Python complex number object."
-msgstr ""
+msgstr "這個 :c:type:`PyObject` 的子型別代表一個 Python 複數物件。"
 
 #: ../../c-api/complex.rst:90
 msgid ""
 "This instance of :c:type:`PyTypeObject` represents the Python complex number "
 "type. It is the same object as :class:`complex` in the Python layer."
 msgstr ""
+"這個 :c:type:`PyTypeObject` 的實例代表 Python 複數型別。它與 Python 層中的 :"
+"class:`complex` 是同一個物件。"
 
 #: ../../c-api/complex.rst:96
 msgid ""
 "Return true if its argument is a :c:type:`PyComplexObject` or a subtype of :"
 "c:type:`PyComplexObject`.  This function always succeeds."
 msgstr ""
+"如果其引數是一個 :c:type:`PyComplexObject` 或者是 :c:type:`PyComplexObject` "
+"的子型別，則會回傳 true。這個函式不會失敗。"
 
 #: ../../c-api/complex.rst:102
 msgid ""
 "Return true if its argument is a :c:type:`PyComplexObject`, but not a "
 "subtype of :c:type:`PyComplexObject`.  This function always succeeds."
 msgstr ""
+"如果其引數是一個 :c:type:`PyComplexObject`，但不是 :c:type:`PyComplexObject` "
+"的子型別，則會回傳 true。這個函式不會失敗。"
 
 #: ../../c-api/complex.rst:108
 msgid ""
 "Create a new Python complex number object from a C :c:type:`Py_complex` "
 "value."
-msgstr ""
+msgstr "從 C 的 :c:type:`Py_complex` 值建立一個新的 Python 複數物件。"
 
 #: ../../c-api/complex.rst:113
 msgid "Return a new :c:type:`PyComplexObject` object from *real* and *imag*."
-msgstr ""
+msgstr "從 *real* 和 *imag* 回傳一個新的 :c:type:`PyComplexObject` 物件。"
 
 #: ../../c-api/complex.rst:118
 msgid "Return the real part of *op* as a C :c:expr:`double`."
-msgstr ""
+msgstr "以 C 的 :c:expr:`double` 形式回傳 *op* 的實部。"
 
 #: ../../c-api/complex.rst:123
 msgid "Return the imaginary part of *op* as a C :c:expr:`double`."
-msgstr ""
+msgstr "將 *op* 的虛部作為 C 的 :c:expr:`double` 回傳。"
 
 #: ../../c-api/complex.rst:128
 msgid "Return the :c:type:`Py_complex` value of the complex number *op*."
-msgstr ""
+msgstr "回傳複數 *op* 的 :c:type:`Py_complex` 值。"
 
 #: ../../c-api/complex.rst:130
 msgid ""
@@ -155,6 +174,11 @@ msgid ""
 "defined then it falls back to :meth:`~object.__index__`.  Upon failure, this "
 "method returns ``-1.0`` as a real value."
 msgstr ""
+"如果 *op* 不是 Python 複數物件，但有一個 :meth:`~object.__complex__` 方法，則"
+"首先會呼叫該方法將 *op* 轉換為 Python 複數物件。如果 :meth:`!__complex__` 並"
+"未定義，那麼它會回退到 :meth:`~object.__float__`。如果 :meth:`!__float__` 未"
+"定義，則它將繼續回退為 :meth:`~object.__index__`。失敗時，此方法回傳 "
+"``-1.0`` 作為實部值。"
 
 #: ../../c-api/complex.rst:137
 msgid "Use :meth:`~object.__index__` if available."
diff --git a/howto/sockets.po b/howto/sockets.po
@@ -8,7 +8,7 @@ msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2022-06-10 00:16+0000\n"
-"PO-Revision-Date: 2023-07-19 20:17+0800\n"
+"PO-Revision-Date: 2023-08-03 18:11+0800\n"
 "Last-Translator: Jay <weijay0804@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -417,7 +417,7 @@ msgstr ""
 
 #: ../../howto/sockets.rst:252
 msgid "Binary Data"
-msgstr ""
+msgstr "二進位資料"
 
 #: ../../howto/sockets.rst:254
 msgid ""
@@ -430,6 +430,13 @@ msgid ""
 "little-endian, with the least significant byte first - that same ``1`` would "
 "be ``01 00``."
 msgstr ""
+"使用 socket 傳輸二進位資料完全是可行的。最主要的問題在於不同機器使用不同的二"
+"進位資料格式。例如，`網路二進位順序 <https://en.wikipedia.org/wiki/"
+"Endianness#Networking>`_ 採用的是「大端序 big-endian」，"
+"所以一個值為 ``1`` 的 16 位元整數會表示成兩個 16 進位的位元組 ``00 01``。然而"
+"大多數常見的處理器 (x86/AMD64，ARM，RISC-V) 採用的是「小端序 little-"
+"endian」，所以相同的 ``1`` 會被表示成 ``01 00``。"
+"（譯者注：將一個多位數的低位放在較小的位址處，高位放在較大的位址處，則稱小端序；反之則稱大端序。）"
 
 #: ../../howto/sockets.rst:262
 msgid ""
@@ -439,6 +446,10 @@ msgid ""
 "these do nothing, but where the machine is byte-reversed, these swap the "
 "bytes around appropriately."
 msgstr ""
+"Socket 函式庫提供了用於轉換 16 位元和 32 位元整數的函式 - ``ntohl, htonl, "
+"ntohs, htons``，其中 \"n\" 表示 *network*，\"h\" 表示 *host*，\"s\" 表示 "
+"*short*，\"l\" 表示 *long*。當網路的位元組順序和主機位元組順序相同時，這些函"
+"式不會做任何操作，但當主機的位元組順序相反時，這些函式會適當的交換位元組順序。"
 
 #: ../../howto/sockets.rst:268
 msgid ""
@@ -449,10 +460,14 @@ msgid ""
 "be 8. Of course, this doesn't fit well with fixed-length messages. "
 "Decisions, decisions."
 msgstr ""
+"在現今的 64 位元機器中，二進位資料的 ASCII 表示通常會比二進位表示要小，這是因"
+"為在很多情況下，大多數整數的值為 0 或者 1。例如，字串形式的 ``\"0\"`` 是兩個"
+"位元組，而完整的 64 位元整數則是 8 個位元組。當然，這對固定長度的訊息來說不太"
+"適合，需要自行決定。"
 
 #: ../../howto/sockets.rst:277
 msgid "Disconnecting"
-msgstr ""
+msgstr "結束連線"
 
 #: ../../howto/sockets.rst:279
 msgid ""
@@ -465,6 +480,12 @@ msgid ""
 "same as ``shutdown(); close()``.  So in most situations, an explicit "
 "``shutdown`` is not needed."
 msgstr ""
+"嚴格來說，在關閉 socket 前，你應該使用 ``shutdown`` 函式。``shutdown`` 函式是"
+"發送給 socket 另一端的一個提醒。根據你傳遞的引數，它可以表示「我不會再發送任"
+"何訊息了，但我仍然會持續監聽」，或者是「我不會再繼續監聽了，真讚！」。然而，"
+"大多數的 socket 函式庫或程式設計師都習慣忽略這種禮節，因為通常情況下 "
+"``close`` 跟 ``shutdown(); close()`` 是一樣的。所以在大多數情況下，不需要再特"
+"地使用 ``shutdown`` 了。"
 
 #: ../../howto/sockets.rst:287
 msgid ""
@@ -475,6 +496,11 @@ msgid ""
 "complete request.  The server sends a reply. If the ``send`` completes "
 "successfully then, indeed, the client was still receiving."
 msgstr ""
+"有效使用 ``shutdown`` 的一種方式是在類似 HTTP 的交換中，用戶端發送請求後，然"
+"後使用 ``shutdown(1)``。這告訴伺服器「這個用戶端已經發送完成，但仍可以接"
+"收」。伺服器可以通過接收「零位元組」來檢測 \"EOF\"。這樣它就可以確定已經接收到"
+"完整的請求。伺服器發送回覆，如果 ``send`` 成功完成，那麼用戶端確實在持續接"
+"收。"
 
 #: ../../howto/sockets.rst:294
 msgid ""
@@ -485,6 +511,11 @@ msgid ""
 "indefinitely, thinking you're just being slow. *Please* ``close`` your "
 "sockets when you're done."
 msgstr ""
+"Python 更進一步地採取自動關閉的步驟，並且當 socket 被垃圾回收機制回收時，如果需要"
+"的話，他會自動執行 ``close``。但依賴這個機制是一個非常不好的習慣，如果你的 "
+"socket 在沒有 ``close`` 的情況下消失了，那麼另一端的 socket 可能會認為你只是"
+"慢了一步，而無期限的等待。*請務必* \\在使用完畢後使用 ``close`` 關閉你的 "
+"sockets。"
 
 #: ../../howto/sockets.rst:302
 msgid "When Sockets Die"
diff --git a/library/csv.po b/library/csv.po
@@ -20,7 +20,7 @@ msgstr ""
 
 #: ../../library/csv.rst:2
 msgid ":mod:`csv` --- CSV File Reading and Writing"
-msgstr ""
+msgstr ":mod:`csv` --- CSV 檔案讀取及寫入"
 
 #: ../../library/csv.rst:9
 msgid "**Source code:** :source:`Lib/csv.py`"
@@ -39,6 +39,13 @@ msgid ""
 "single module which can efficiently manipulate such data, hiding the details "
 "of reading and writing the data from the programmer."
 msgstr ""
+"所謂的 CSV (Comma Separated Values) 檔案格式是試算表及資料庫中最常見的"
+"匯入、匯出檔案格式。在嘗試以 :rfc:`4180` 中的標準化方式來描述格式之前，"
+"CSV 格式已經使用了許多年。由於缺少一個完善定義的標準，意味著各個不同的"
+"應用程式會在資料產生及銷毀時有微妙的差別。這些不同之處使得從不同資料來源"
+"處理 CSV 檔案時會非常擾人。儘管如此，雖然分隔符號和引號字元有所不同，整體的"
+"格式非常相似，可以寫個單一模組來高效率的操作這樣的資料，讓程式設計師可以隱藏"
+"讀取及寫入資料的細節。"
 
 #: ../../library/csv.rst:28
 msgid ""
@@ -56,6 +63,9 @@ msgid ""
 "write sequences.  Programmers can also read and write data in dictionary "
 "form using the :class:`DictReader` and :class:`DictWriter` classes."
 msgstr ""
+":mod:`csv` 模組的 :class:`reader` 及 :class:`writer` 物件可以讀取"
+"及寫入序列。程式設計師也可以透過 :class:`DictReader` 及 :class:`DictWriter`"
+" class（類別）使用 dictionary （字典）讀取及寫入資料。"
 
 #: ../../library/csv.rst:41
 msgid ":pep:`305` - CSV File API"
