sync with cpython b3725651

Author: github-actions[bot]

library/asyncio-stream.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-06-27 07:36+0000\n"
+"POT-Creation-Date: 2025-08-19 00:16+0000\n"
 "PO-Revision-Date: 2022-10-31 16:28+0800\n"
 "Last-Translator: Matt Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -42,7 +42,7 @@ msgstr ""
 msgid "Here is an example of a TCP echo client written using asyncio streams::"
 msgstr "這是一個使用 asyncio 串流編寫的 TCP echo 用戶端範例： ::"
 
-#: ../../library/asyncio-stream.rst:22 ../../library/asyncio-stream.rst:437
+#: ../../library/asyncio-stream.rst:22 ../../library/asyncio-stream.rst:440
 msgid ""
 "import asyncio\n"
 "\n"
@@ -146,7 +146,7 @@ msgstr "移除 *loop* 參數。"
 
 #: ../../library/asyncio-stream.rst:87 ../../library/asyncio-stream.rst:131
 #: ../../library/asyncio-stream.rst:167 ../../library/asyncio-stream.rst:202
-#: ../../library/asyncio-stream.rst:404
+#: ../../library/asyncio-stream.rst:407
 msgid "Added the *ssl_shutdown_timeout* parameter."
 msgstr "新增 *ssl_shutdown_timeout* 參數。"
 
@@ -409,7 +409,7 @@ msgstr ""
 "此方法會嘗試立即將 *data* 寫入到底層的 socket。如果失敗，資料會被放到內部寫入"
 "緩衝中排隊等待 (queue)，直到它可被發送。"
 
-#: ../../library/asyncio-stream.rst:319 ../../library/asyncio-stream.rst:331
+#: ../../library/asyncio-stream.rst:319 ../../library/asyncio-stream.rst:334
 msgid "The method should be used along with the ``drain()`` method::"
 msgstr "此方法應當與 ``drain()`` 方法一起使用： ::"
 
@@ -421,7 +421,13 @@ msgstr ""
 "stream.write(data)\n"
 "await stream.drain()"
 
-#: ../../library/asyncio-stream.rst:326
+#: ../../library/asyncio-stream.rst:325
+msgid ""
+"The *data* buffer should be a C contiguous one-dimensional :term:`bytes-like "
+"object <bytes-like object>`."
+msgstr ""
+
+#: ../../library/asyncio-stream.rst:329
 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 "
@@ -430,68 +436,68 @@ msgstr ""
 "此方法會立即嘗試將一個位元組 list（或任何可疊代物件 (iterable)）寫入到底層的 "
 "socket。如果失敗，資料會被放到內部寫入緩衝中排隊等待，直到它可被發送。"
 
-#: ../../library/asyncio-stream.rst:333
+#: ../../library/asyncio-stream.rst:336
 msgid ""
 "stream.writelines(lines)\n"
 "await stream.drain()"
 msgstr ""
 "stream.writelines(lines)\n"
 "await stream.drain()"
 
-#: ../../library/asyncio-stream.rst:338
+#: ../../library/asyncio-stream.rst:341
 msgid "The method closes the stream and the underlying socket."
 msgstr "此方法會關閉串流以及底層的 socket。"
 
-#: ../../library/asyncio-stream.rst:340
+#: ../../library/asyncio-stream.rst:343
 msgid ""
 "The method should be used, though not mandatory, along with the "
 "``wait_closed()`` method::"
 msgstr "此方法應與 ``wait_closed()`` 方法一起使用，但並非強制： ::"
 
-#: ../../library/asyncio-stream.rst:343
+#: ../../library/asyncio-stream.rst:346
 msgid ""
 "stream.close()\n"
 "await stream.wait_closed()"
 msgstr ""
 "stream.close()\n"
 "await stream.wait_closed()"
 
-#: ../../library/asyncio-stream.rst:348
+#: ../../library/asyncio-stream.rst:351
 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:353
+#: ../../library/asyncio-stream.rst:356
 msgid ""
 "Close the write end of the stream after the buffered write data is flushed."
 msgstr "在已緩衝的寫入資料被清理 (flush) 後關閉串流的寫入端。"
 
-#: ../../library/asyncio-stream.rst:358
+#: ../../library/asyncio-stream.rst:361
 msgid "Return the underlying asyncio transport."
 msgstr "回傳底層的 asyncio 傳輸。"
 
-#: ../../library/asyncio-stream.rst:362
+#: ../../library/asyncio-stream.rst:365
 msgid ""
 "Access optional transport information; see :meth:`BaseTransport."
 "get_extra_info` for details."
 msgstr "存取可選的傳輸資訊；詳情請見 :meth:`BaseTransport.get_extra_info`。"
 
-#: ../../library/asyncio-stream.rst:368
+#: ../../library/asyncio-stream.rst:371
 msgid "Wait until it is appropriate to resume writing to the stream. Example::"
 msgstr "等待直到可以繼續寫入到串流。範例： ::"
 
-#: ../../library/asyncio-stream.rst:371
+#: ../../library/asyncio-stream.rst:374
 msgid ""
 "writer.write(data)\n"
 "await writer.drain()"
 msgstr ""
 "writer.write(data)\n"
 "await writer.drain()"
 
-#: ../../library/asyncio-stream.rst:374
+#: ../../library/asyncio-stream.rst:377
 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()* "
@@ -503,48 +509,48 @@ msgstr ""
 "(high watermark) 時，*drain()* 會阻塞直到緩衝區大小減少至最低標記位 (low "
 "watermark) 以便繼續寫入。當沒有要等待的資料時，:meth:`drain` 會立即回傳。"
 
-#: ../../library/asyncio-stream.rst:385
+#: ../../library/asyncio-stream.rst:388
 msgid "Upgrade an existing stream-based connection to TLS."
 msgstr "將現有的基於串流的連線升級到 TLS。"
 
-#: ../../library/asyncio-stream.rst:387
+#: ../../library/asyncio-stream.rst:390
 msgid "Parameters:"
 msgstr "參數："
 
-#: ../../library/asyncio-stream.rst:389
+#: ../../library/asyncio-stream.rst:392
 msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
 msgstr "*sslcontext*：一個 :class:`~ssl.SSLContext` 的已配置實例。"
 
-#: ../../library/asyncio-stream.rst:391
+#: ../../library/asyncio-stream.rst:394
 msgid ""
 "*server_hostname*: sets or overrides the host name that the target server's "
 "certificate will be matched against."
 msgstr "*server_hostname*：設定或覆寫將會被目標伺服器憑證比對的主機名稱。"
 
-#: ../../library/asyncio-stream.rst:394
+#: ../../library/asyncio-stream.rst:397
 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:398
+#: ../../library/asyncio-stream.rst:401
 msgid ""
 "*ssl_shutdown_timeout* is the time in seconds to wait for the SSL shutdown "
 "to complete before aborting the connection. ``30.0`` seconds if ``None`` "
 "(default)."
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:410
+#: ../../library/asyncio-stream.rst:413
 msgid ""
 "Return ``True`` if the stream is closed or in the process of being closed."
 msgstr "如果串流已被關閉或正在被關閉則回傳 ``True``。"
 
-#: ../../library/asyncio-stream.rst:418
+#: ../../library/asyncio-stream.rst:421
 msgid "Wait until the stream is closed."
 msgstr "等待直到串流被關閉。"
 
-#: ../../library/asyncio-stream.rst:420
+#: ../../library/asyncio-stream.rst:423
 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 "
@@ -553,19 +559,19 @@ msgstr ""
 "應當在 :meth:`close` 之後才被呼叫，這會持續等待直到底層的連線被關閉，以確保在"
 "這之前（例如在程式退出前）所有資料都已經被清空"
 
-#: ../../library/asyncio-stream.rst:428
+#: ../../library/asyncio-stream.rst:431
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/asyncio-stream.rst:433
+#: ../../library/asyncio-stream.rst:436
 msgid "TCP echo client using streams"
 msgstr "使用串流的 TCP echo 用戶端"
 
-#: ../../library/asyncio-stream.rst:435
+#: ../../library/asyncio-stream.rst:438
 msgid "TCP echo client using the :func:`asyncio.open_connection` function::"
 msgstr "使用 :func:`asyncio.open_connection` 函式的 TCP echo 用戶端： ::"
 
-#: ../../library/asyncio-stream.rst:459
+#: ../../library/asyncio-stream.rst:462
 msgid ""
 "The :ref:`TCP echo client protocol "
 "<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
@@ -574,15 +580,15 @@ msgstr ""
 "使用低階 :meth:`loop.create_connection` 方法的 :ref:`TCP echo 用戶端協定 "
 "<asyncio_example_tcp_echo_client_protocol>`\\ 範例。"
 
-#: ../../library/asyncio-stream.rst:466
+#: ../../library/asyncio-stream.rst:469
 msgid "TCP echo server using streams"
 msgstr "使用串流的 TCP echo 伺服器"
 
-#: ../../library/asyncio-stream.rst:468
+#: ../../library/asyncio-stream.rst:471
 msgid "TCP echo server using the :func:`asyncio.start_server` function::"
 msgstr "TCP echo 伺服器使用 :func:`asyncio.start_server` 函式： ::"
 
-#: ../../library/asyncio-stream.rst:470
+#: ../../library/asyncio-stream.rst:473
 msgid ""
 "import asyncio\n"
 "\n"
@@ -642,7 +648,7 @@ msgstr ""
 "\n"
 "asyncio.run(main())"
 
-#: ../../library/asyncio-stream.rst:502
+#: ../../library/asyncio-stream.rst:505
 msgid ""
 "The :ref:`TCP echo server protocol "
 "<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
@@ -651,16 +657,16 @@ msgstr ""
 "使用 :meth:`loop.create_server` 方法的 :ref:`TCP echo 伺服器協定 "
 "<asyncio_example_tcp_echo_server_protocol>` 範例。"
 
-#: ../../library/asyncio-stream.rst:507
+#: ../../library/asyncio-stream.rst:510
 msgid "Get HTTP headers"
 msgstr "取得 HTTP 標頭"
 
-#: ../../library/asyncio-stream.rst:509
+#: ../../library/asyncio-stream.rst:512
 msgid ""
 "Simple example querying HTTP headers of the URL passed on the command line::"
 msgstr "查詢自命令列傳入之 URL 所帶有 HTTP 標頭的簡單範例： ::"
 
-#: ../../library/asyncio-stream.rst:511
+#: ../../library/asyncio-stream.rst:514
 msgid ""
 "import asyncio\n"
 "import urllib.parse\n"
@@ -699,34 +705,34 @@ msgid ""
 "asyncio.run(print_http_headers(url))"
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:548
+#: ../../library/asyncio-stream.rst:551
 msgid "Usage::"
 msgstr "用法： ::"
 
-#: ../../library/asyncio-stream.rst:550
+#: ../../library/asyncio-stream.rst:553
 msgid "python example.py http://example.com/path/page.html"
 msgstr "python example.py http://example.com/path/page.html"
 
-#: ../../library/asyncio-stream.rst:552
+#: ../../library/asyncio-stream.rst:555
 msgid "or with HTTPS::"
 msgstr "或使用 HTTPS： ::"
 
-#: ../../library/asyncio-stream.rst:554
+#: ../../library/asyncio-stream.rst:557
 msgid "python example.py https://example.com/path/page.html"
 msgstr "python example.py https://example.com/path/page.html"
 
-#: ../../library/asyncio-stream.rst:560
+#: ../../library/asyncio-stream.rst:563
 msgid "Register an open socket to wait for data using streams"
 msgstr "註冊一個使用串流來等待資料的開放 socket"
 
-#: ../../library/asyncio-stream.rst:562
+#: ../../library/asyncio-stream.rst:565
 msgid ""
 "Coroutine waiting until a socket receives data using the :func:"
 "`open_connection` function::"
 msgstr ""
 "等待直到 socket 透過使用 :func:`open_connection` 函式接收到資料的協程： ::"
 
-#: ../../library/asyncio-stream.rst:565
+#: ../../library/asyncio-stream.rst:568
 msgid ""
 "import asyncio\n"
 "import socket\n"
@@ -759,7 +765,7 @@ msgid ""
 "asyncio.run(wait_for_data())"
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:597
+#: ../../library/asyncio-stream.rst:600
 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 "
@@ -769,7 +775,7 @@ msgstr ""
 "<asyncio_example_create_connection>`\\ 範例中，有使用了低階協定以及 :meth:"
 "`loop.create_connection` 方法。"
 
-#: ../../library/asyncio-stream.rst:601
+#: ../../library/asyncio-stream.rst:604
 msgid ""
 "The :ref:`watch a file descriptor for read events "
 "<asyncio_example_watch_fd>` example uses the low-level :meth:`loop."