sync with cpython 5e1bbb58

github-actions[bot] · mattwang44 · commit f060abf9d736 · 2023-03-04T18:19:27.000+08:00
diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-02-13 00:17+0000\n"
+"POT-Creation-Date: 2023-02-24 00:17+0000\n"
 "PO-Revision-Date: 2022-10-31 16:28+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -223,41 +223,50 @@ msgstr ""
 "`start_server` 會是較好的做法。"
 
 #: ../../library/asyncio-stream.rst:209
-msgid ""
-"Read up to *n* bytes.  If *n* is not provided, or set to ``-1``, read until "
-"EOF and return all read bytes."
+msgid "Read up to *n* bytes from the stream."
 msgstr ""
-"讀取至多 *n* 個位元組。如果沒有設定 *n* 或被設為 ``-1``，則表示要持續讀取直"
-"到 EOF 並回傳所有已讀取的位元組。"
 
-#: ../../library/asyncio-stream.rst:212
+#: ../../library/asyncio-stream.rst:211
+#, fuzzy
 msgid ""
-"If EOF was received and the internal buffer is empty, return an empty "
-"``bytes`` object."
+"If *n* is not provided or set to ``-1``, read until EOF, then return all "
+"read :class:`bytes`. If EOF was received and the internal buffer is empty, "
+"return an empty ``bytes`` object."
 msgstr "如果讀取到 EOF 且內部緩衝區是空的，則回傳一個空的 ``bytes`` 物件。"
 
-#: ../../library/asyncio-stream.rst:217
+#: ../../library/asyncio-stream.rst:216
+msgid "If *n* is ``0``, return an empty ``bytes`` object immediately."
+msgstr ""
+
+#: ../../library/asyncio-stream.rst:218
+msgid ""
+"If *n* is positive, return at most *n* available ``bytes`` as soon as at "
+"least 1 byte is available in the internal buffer. If EOF is received before "
+"any byte is read, return an empty ``bytes`` object."
+msgstr ""
+
+#: ../../library/asyncio-stream.rst:225
 msgid ""
 "Read one line, where \"line\" is a sequence of bytes ending with ``\\n``."
 msgstr "讀取一行，其中\"行\"指的是以 ``\\n`` 結尾的位元組序列。"
 
-#: ../../library/asyncio-stream.rst:220
+#: ../../library/asyncio-stream.rst:228
 msgid ""
 "If EOF is received and ``\\n`` was not found, the method returns partially "
 "read data."
 msgstr "如果讀取到 EOF 而沒有找到 ``\\n``，該方法會回傳部分的已讀取資料。"
 
-#: ../../library/asyncio-stream.rst:223
+#: ../../library/asyncio-stream.rst:231
 msgid ""
 "If EOF is received and the internal buffer is empty, return an empty "
 "``bytes`` object."
 msgstr "如果讀取到 EOF 且內部緩衝區是空的，則回傳一個空的 ``bytes`` 物件。"
 
-#: ../../library/asyncio-stream.rst:228
+#: ../../library/asyncio-stream.rst:236
 msgid "Read exactly *n* bytes."
 msgstr "讀取剛好 *n* 個位元組。"
 
-#: ../../library/asyncio-stream.rst:230
+#: ../../library/asyncio-stream.rst:238
 msgid ""
 "Raise an :exc:`IncompleteReadError` if EOF is reached before *n* can be "
 "read.  Use the :attr:`IncompleteReadError.partial` attribute to get the "
@@ -267,19 +276,19 @@ msgstr ""
 "`IncompleteReadError`。使用 :attr:`IncompleteReadError.partial` 屬性來獲取串"
 "流結束前已讀取的部分資料。"
 
-#: ../../library/asyncio-stream.rst:236
+#: ../../library/asyncio-stream.rst:244
 msgid "Read data from the stream until *separator* is found."
 msgstr "從串流中持續讀取資料直到出現 *separator*。"
 
-#: ../../library/asyncio-stream.rst:238
+#: ../../library/asyncio-stream.rst:246
 msgid ""
 "On success, the data and separator will be removed from the internal buffer "
 "(consumed). Returned data will include the separator at the end."
 msgstr ""
 "成功後，資料和 separator（分隔符號）會從內部緩衝區中刪除（或者說是被消費掉 "
 "(consumed)）。回傳的資料在末尾會有一個 separator。"
 
-#: ../../library/asyncio-stream.rst:242
+#: ../../library/asyncio-stream.rst:250
 msgid ""
 "If the amount of data read exceeds the configured stream limit, a :exc:"
 "`LimitOverrunError` exception is raised, and the data is left in the "
@@ -288,7 +297,7 @@ msgstr ""
 "如果讀取的資料量超過了設定的串流限制，將會引發 :exc:`LimitOverrunError` 例"
 "外，資料將被留在內部緩衝區中，並可以再次被讀取。"
 
-#: ../../library/asyncio-stream.rst:246
+#: ../../library/asyncio-stream.rst:254
 msgid ""
 "If EOF is reached before the complete separator is found, an :exc:"
 "`IncompleteReadError` exception is raised, and the internal buffer is "
@@ -299,28 +308,28 @@ msgstr ""
 "`IncompleteReadError` 例外，且內部緩衝區會被重置。:attr:`IncompleteReadError."
 "partial` 屬性可能包含一部分的 separator。"
 
-#: ../../library/asyncio-stream.rst:255
+#: ../../library/asyncio-stream.rst:263
 msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called."
 msgstr "如果緩衝區是空的且 :meth:`feed_eof` 曾被呼叫則回傳 ``True``。"
 
-#: ../../library/asyncio-stream.rst:260
+#: ../../library/asyncio-stream.rst:268
 msgid "StreamWriter"
 msgstr "StreamWriter"
 
-#: ../../library/asyncio-stream.rst:264
+#: ../../library/asyncio-stream.rst:272
 msgid ""
 "Represents a writer object that provides APIs to write data to the IO stream."
 msgstr "表示一個有提供 API 來將資料寫入 IO 串流的 writer 物件。"
 
-#: ../../library/asyncio-stream.rst:267
+#: ../../library/asyncio-stream.rst:275
 msgid ""
 "It is not recommended to instantiate *StreamWriter* objects directly; use :"
 "func:`open_connection` and :func:`start_server` instead."
 msgstr ""
 "不建議直接實例化 *StreamWriter* 物件；使用 :func:`open_connection` 和 :func:"
 "`start_server` 會是較好的做法。"
 
-#: ../../library/asyncio-stream.rst:273
+#: ../../library/asyncio-stream.rst:281
 msgid ""
 "The method attempts to write the *data* to the underlying socket "
 "immediately. If that fails, the data is queued in an internal write buffer "
@@ -329,14 +338,14 @@ msgstr ""
 "此方法會嘗試立即將 *data* 寫入到底層的 socket。如果失敗，資料會被放到內部寫入"
 "緩衝中排隊等待 (queue)，直到它可被發送。"
 
-#: ../../library/asyncio-stream.rst:277 ../../library/asyncio-stream.rst:289
+#: ../../library/asyncio-stream.rst:285 ../../library/asyncio-stream.rst:297
 msgid "The method should be used along with the ``drain()`` method::"
 msgstr ""
 "此方法應當與 ``drain()`` 方法一起使用：\n"
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:284
+#: ../../library/asyncio-stream.rst:292
 msgid ""
 "The method writes a list (or any iterable) of bytes to the underlying socket "
 "immediately. If that fails, the data is queued in an internal write buffer "
@@ -345,11 +354,11 @@ msgstr ""
 "此方法會立即嘗試將一個位元組 list（或任何可疊代物件 (iterable)）寫入到底層的 "
 "socket。如果失敗，資料會被放到內部寫入緩衝中排隊等待，直到它可被發送。"
 
-#: ../../library/asyncio-stream.rst:296
+#: ../../library/asyncio-stream.rst:304
 msgid "The method closes the stream and the underlying socket."
 msgstr "此方法會關閉串流以及底層的 socket。"
 
-#: ../../library/asyncio-stream.rst:298
+#: ../../library/asyncio-stream.rst:306
 msgid ""
 "The method should be used, though not mandatory, along with the "
 "``wait_closed()`` method::"
@@ -358,37 +367,37 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:306
+#: ../../library/asyncio-stream.rst:314
 msgid ""
 "Return ``True`` if the underlying transport supports the :meth:`write_eof` "
 "method, ``False`` otherwise."
 msgstr ""
 "如果底層的傳輸支援 :meth:`write_eof` 方法就回傳 ``True``，否則回傳 "
 "``False``。"
 
-#: ../../library/asyncio-stream.rst:311
+#: ../../library/asyncio-stream.rst:319
 msgid ""
 "Close the write end of the stream after the buffered write data is flushed."
 msgstr "在已緩衝的寫入資料被清理 (flush) 後關閉串流的寫入端。"
 
-#: ../../library/asyncio-stream.rst:316
+#: ../../library/asyncio-stream.rst:324
 msgid "Return the underlying asyncio transport."
 msgstr "回傳底層的 asyncio 傳輸。"
 
-#: ../../library/asyncio-stream.rst:320
+#: ../../library/asyncio-stream.rst:328
 msgid ""
 "Access optional transport information; see :meth:`BaseTransport."
 "get_extra_info` for details."
 msgstr "存取可選的傳輸資訊；詳情請見 :meth:`BaseTransport.get_extra_info`。"
 
-#: ../../library/asyncio-stream.rst:325
+#: ../../library/asyncio-stream.rst:333
 msgid "Wait until it is appropriate to resume writing to the stream. Example::"
 msgstr ""
 "等待直到可以繼續寫入到串流。範例：\n"
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:331
+#: ../../library/asyncio-stream.rst:339
 msgid ""
 "This is a flow control method that interacts with the underlying IO write "
 "buffer.  When the size of the buffer reaches the high watermark, *drain()* "
@@ -400,41 +409,41 @@ msgstr ""
 "(high watermark) 時，*drain()* 會阻塞直到緩衝區大小減少至最低標記位 (low "
 "watermark) 以便繼續寫入。當沒有要等待的資料時，:meth:`drain` 會立即回傳。"
 
-#: ../../library/asyncio-stream.rst:341
+#: ../../library/asyncio-stream.rst:349
 msgid "Upgrade an existing stream-based connection to TLS."
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:343
+#: ../../library/asyncio-stream.rst:351
 msgid "Parameters:"
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:345
+#: ../../library/asyncio-stream.rst:353
 msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:347
+#: ../../library/asyncio-stream.rst:355
 msgid ""
 "*server_hostname*: sets or overrides the host name that the target server's "
 "certificate will be matched against."
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:350
+#: ../../library/asyncio-stream.rst:358
 msgid ""
 "*ssl_handshake_timeout* is the time in seconds to wait for the TLS handshake "
 "to complete before aborting the connection.  ``60.0`` seconds if ``None`` "
 "(default)."
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:358
+#: ../../library/asyncio-stream.rst:366
 msgid ""
 "Return ``True`` if the stream is closed or in the process of being closed."
 msgstr "如果串流已被關閉或正在被關閉則回傳 ``True``。"
 
-#: ../../library/asyncio-stream.rst:365
+#: ../../library/asyncio-stream.rst:373
 msgid "Wait until the stream is closed."
 msgstr "等待直到串流被關閉。"
 
-#: ../../library/asyncio-stream.rst:367
+#: ../../library/asyncio-stream.rst:375
 msgid ""
 "Should be called after :meth:`close` to wait until the underlying connection "
 "is closed, ensuring that all data has been flushed before e.g. exiting the "
@@ -443,22 +452,22 @@ msgstr ""
 "應當在 :meth:`close` 之後才被呼叫，這會持續等待直到底層的連線被關閉，以確保在"
 "這之前（例如在程式退出前）所有資料都已經被清空"
 
-#: ../../library/asyncio-stream.rst:375
+#: ../../library/asyncio-stream.rst:383
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/asyncio-stream.rst:380
+#: ../../library/asyncio-stream.rst:388
 msgid "TCP echo client using streams"
 msgstr "使用串流的 TCP echo 客戶端"
 
-#: ../../library/asyncio-stream.rst:382
+#: ../../library/asyncio-stream.rst:390
 msgid "TCP echo client using the :func:`asyncio.open_connection` function::"
 msgstr ""
 "使用 :func:`asyncio.open_connection` 函式的 TCP echo 客戶端：\n"
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:406
+#: ../../library/asyncio-stream.rst:414
 msgid ""
 "The :ref:`TCP echo client protocol "
 "<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
@@ -467,18 +476,18 @@ msgstr ""
 "使用低階 :meth:`loop.create_connection` 方法的 :ref:`TCP echo 客戶端協定 "
 "<asyncio_example_tcp_echo_client_protocol>`\\ 範例。"
 
-#: ../../library/asyncio-stream.rst:413
+#: ../../library/asyncio-stream.rst:421
 msgid "TCP echo server using streams"
 msgstr "使用串流的 TCP echo 伺服器"
 
-#: ../../library/asyncio-stream.rst:415
+#: ../../library/asyncio-stream.rst:423
 msgid "TCP echo server using the :func:`asyncio.start_server` function::"
 msgstr ""
 "TCP echo 伺服器使用 :func:`asyncio.start_server` 函式：\n"
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:449
+#: ../../library/asyncio-stream.rst:457
 msgid ""
 "The :ref:`TCP echo server protocol "
 "<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
@@ -487,37 +496,37 @@ msgstr ""
 "使用 :meth:`loop.create_server` 方法的 :ref:`TCP echo 伺服器協定 "
 "<asyncio_example_tcp_echo_server_protocol>` 範例。"
 
-#: ../../library/asyncio-stream.rst:454
+#: ../../library/asyncio-stream.rst:462
 msgid "Get HTTP headers"
 msgstr "獲取 HTTP 標頭"
 
-#: ../../library/asyncio-stream.rst:456
+#: ../../library/asyncio-stream.rst:464
 msgid ""
 "Simple example querying HTTP headers of the URL passed on the command line::"
 msgstr ""
 "查詢自命令列傳入之 URL 所帶有 HTTP 標頭的簡單範例：\n"
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:495
+#: ../../library/asyncio-stream.rst:503
 msgid "Usage::"
 msgstr ""
 "用法：\n"
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:499
+#: ../../library/asyncio-stream.rst:507
 msgid "or with HTTPS::"
 msgstr ""
 "或使用 HTTPS：\n"
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:507
+#: ../../library/asyncio-stream.rst:515
 msgid "Register an open socket to wait for data using streams"
 msgstr "註冊一個使用串流來等待資料的開放 socket"
 
-#: ../../library/asyncio-stream.rst:509
+#: ../../library/asyncio-stream.rst:517
 msgid ""
 "Coroutine waiting until a socket receives data using the :func:"
 "`open_connection` function::"
@@ -526,7 +535,7 @@ msgstr ""
 "\n"
 "::"
 
-#: ../../library/asyncio-stream.rst:544
+#: ../../library/asyncio-stream.rst:552
 msgid ""
 "The :ref:`register an open socket to wait for data using a protocol "
 "<asyncio_example_create_connection>` example uses a low-level protocol and "
@@ -536,11 +545,18 @@ msgstr ""
 "<asyncio_example_create_connection>`\\ 範例中，有使用了低階協定以及 :meth:"
 "`loop.create_connection` 方法。"
 
-#: ../../library/asyncio-stream.rst:548
+#: ../../library/asyncio-stream.rst:556
 msgid ""
 "The :ref:`watch a file descriptor for read events "
 "<asyncio_example_watch_fd>` example uses the low-level :meth:`loop."
 "add_reader` method to watch a file descriptor."
 msgstr ""
 "在\\ :ref:`監視檔案描述器以讀取事件 <asyncio_example_watch_fd>`\\ 範例中，有"
 "使用低階的 :meth:`loop.add_reader` 方法來監視檔案描述器。"
+
+#~ msgid ""
+#~ "Read up to *n* bytes.  If *n* is not provided, or set to ``-1``, read "
+#~ "until EOF and return all read bytes."
+#~ msgstr ""
+#~ "讀取至多 *n* 個位元組。如果沒有設定 *n* 或被設為 ``-1``，則表示要持續讀取"
+#~ "直到 EOF 並回傳所有已讀取的位元組。"
