diff --git a/library/asyncio-queue.po b/library/asyncio-queue.po index ce2b1a7dca..68b26ece7f 100644 --- a/library/asyncio-queue.po +++ b/library/asyncio-queue.po @@ -1,15 +1,16 @@ -# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2022, Python Software Foundation # This file is distributed under the same license as the Python package. # # Translators: +# Adrian Liaw , 2018 +# Matt Wang , 2022 msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2022-02-19 00:13+0000\n" -"PO-Revision-Date: 2018-05-23 14:39+0000\n" -"Last-Translator: Adrian Liaw \n" +"PO-Revision-Date: 2022-02-20 18:34+0800\n" +"Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" "tw)\n" "Language: zh_TW\n" @@ -17,10 +18,11 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" +"X-Generator: Poedit 3.0.1\n" #: ../../library/asyncio-queue.rst:7 msgid "Queues" -msgstr "" +msgstr "佇列 (Queues)" #: ../../library/asyncio-queue.rst:9 msgid "**Source code:** :source:`Lib/asyncio/queues.py`" @@ -32,24 +34,28 @@ msgid "" "module. Although asyncio queues are not thread-safe, they are designed to " "be used specifically in async/await code." msgstr "" +"asyncio 佇列被設計成與 :mod:`queue` 模組類似。儘管 asyncio 佇列不支援執行緒安" +"全 (thread-safe),但他們是被設計來專用於 async/await 程式。" #: ../../library/asyncio-queue.rst:17 msgid "" "Note that methods of asyncio queues don't have a *timeout* parameter; use :" "func:`asyncio.wait_for` function to do queue operations with a timeout." msgstr "" +"注意 asyncio 的佇列沒有 *timeout* 參數;請使用 :func:`asyncio.wait_for` 函式" +"來為佇列新增具有超時 (timeout) 設定的操作。" #: ../../library/asyncio-queue.rst:21 msgid "See also the `Examples`_ section below." -msgstr "另請參閱下方\\ `Examples`_\\ 。" +msgstr "另請參閱下方 `Examples`_\\ 。" #: ../../library/asyncio-queue.rst:24 msgid "Queue" -msgstr "" +msgstr "Queue" #: ../../library/asyncio-queue.rst:28 msgid "A first in, first out (FIFO) queue." -msgstr "" +msgstr "先進先出 (FIFO) 佇列。" #: ../../library/asyncio-queue.rst:30 msgid "" @@ -57,53 +63,60 @@ msgid "" "it is an integer greater than ``0``, then ``await put()`` blocks when the " "queue reaches *maxsize* until an item is removed by :meth:`get`." msgstr "" +"如果 *maxsize* 小於或等於零,則佇列尺寸是無限制的。如果是大於 ``0`` 的整數," +"則當佇列達到 *maxsize* 時,\\ ``await put()`` 將會阻塞 (block),直到某個元素" +"被 :meth:`get` 取出。" #: ../../library/asyncio-queue.rst:35 msgid "" "Unlike the standard library threading :mod:`queue`, the size of the queue is " "always known and can be returned by calling the :meth:`qsize` method." msgstr "" +"不像標準函式庫中執行緒類型的 :mod:`queue`\\ ,佇列的尺寸一直是已知的,可以透" +"過呼叫 :meth:`qsize` 方法回傳。" #: ../../library/asyncio-queue.rst:39 msgid "Removed the *loop* parameter." -msgstr "" +msgstr "移除 *loop* 參數。" #: ../../library/asyncio-queue.rst:43 msgid "This class is :ref:`not thread safe `." -msgstr "" +msgstr "這個類別是\\ :ref:`不支援執行緒安全的 `\\ 。" #: ../../library/asyncio-queue.rst:47 msgid "Number of items allowed in the queue." -msgstr "" +msgstr "佇列中可存放的元素數量。" #: ../../library/asyncio-queue.rst:51 msgid "Return ``True`` if the queue is empty, ``False`` otherwise." -msgstr "" +msgstr "如果佇列為空則回傳 ``True``\\ ,否則回傳 ``False``\\ 。" #: ../../library/asyncio-queue.rst:55 msgid "Return ``True`` if there are :attr:`maxsize` items in the queue." -msgstr "" +msgstr "如果有 :attr:`maxsize` 個條目在佇列中,則回傳 ``True``\\ 。" #: ../../library/asyncio-queue.rst:57 msgid "" "If the queue was initialized with ``maxsize=0`` (the default), then :meth:" "`full()` never returns ``True``." msgstr "" +"如果佇列用 ``maxsize=0`` (預設)初始化,則 :meth:`full()` 永遠不會回傳 " +"``True``\\ 。" #: ../../library/asyncio-queue.rst:62 msgid "" "Remove and return an item from the queue. If queue is empty, wait until an " "item is available." -msgstr "" +msgstr "從佇列中刪除並回傳一個元素。如果佇列為空,則持續等待直到佇列中有元素。" #: ../../library/asyncio-queue.rst:67 msgid "" "Return an item if one is immediately available, else raise :exc:`QueueEmpty`." -msgstr "" +msgstr "如果佇列內有值則立即回傳佇列中的元素,否則引發 :exc:`QueueEmpty`\\ 。" #: ../../library/asyncio-queue.rst:72 msgid "Block until all items in the queue have been received and processed." -msgstr "" +msgstr "持續阻塞直到佇列中所有的元素都被接收和處理完畢。" #: ../../library/asyncio-queue.rst:74 msgid "" @@ -113,28 +126,34 @@ msgid "" "complete. When the count of unfinished tasks drops to zero, :meth:`join` " "unblocks." msgstr "" +"當條目新增到佇列的時候,未完成任務的計數就會增加。每當一個消耗者 (consumer) " +"協程呼叫 :meth:`task_done`\\ ,表示這個條目已經被取回且被它包含的所有工作都已" +"完成,未完成任務計數就會減少。當未完成計數降到零的時候,\\ :meth:`join` 阻塞" +"會被解除 (unblock)。" #: ../../library/asyncio-queue.rst:82 msgid "" "Put an item into the queue. If the queue is full, wait until a free slot is " "available before adding the item." msgstr "" +"將一個元素放進佇列。如果佇列滿了,在新增元素之前,會持續等待直到有空閒插槽 " +"(free slot) 能被使用。" #: ../../library/asyncio-queue.rst:87 msgid "Put an item into the queue without blocking." -msgstr "" +msgstr "不阻塞地將一個元素放入佇列。" #: ../../library/asyncio-queue.rst:89 msgid "If no free slot is immediately available, raise :exc:`QueueFull`." -msgstr "" +msgstr "如果沒有立即可用的空閒插槽,引發 :exc:`QueueFull`\\ 。" #: ../../library/asyncio-queue.rst:93 msgid "Return the number of items in the queue." -msgstr "" +msgstr "回傳佇列中的元素數量。" #: ../../library/asyncio-queue.rst:97 msgid "Indicate that a formerly enqueued task is complete." -msgstr "" +msgstr "表示前面一個排隊的任務已經完成。" #: ../../library/asyncio-queue.rst:99 msgid "" @@ -142,6 +161,8 @@ msgid "" "subsequent call to :meth:`task_done` tells the queue that the processing on " "the task is complete." msgstr "" +"由佇列消耗者使用。對於每個用於獲取一個任務的 :meth:`~Queue.get`\\ ,接續的 :" +"meth:`task_done` 呼叫會告訴佇列這個任務的處理已經完成。" #: ../../library/asyncio-queue.rst:103 msgid "" @@ -149,36 +170,39 @@ msgid "" "been processed (meaning that a :meth:`task_done` call was received for every " "item that had been :meth:`~Queue.put` into the queue)." msgstr "" +"如果 :meth:`join` 當前正在阻塞,在所有項目都被處理後會解除阻塞(意味著每個" +"以 :meth:`~Queue.put` 放進佇列的條目都會收到一個 :meth:`task_done`\\ )。" #: ../../library/asyncio-queue.rst:108 msgid "" "Raises :exc:`ValueError` if called more times than there were items placed " "in the queue." msgstr "" +"如果被呼叫的次數多於放入佇列中的項目數量,將引發 :exc:`ValueError`\\ 。" #: ../../library/asyncio-queue.rst:113 msgid "Priority Queue" -msgstr "" +msgstr "Priority Queue(優先佇列)" #: ../../library/asyncio-queue.rst:117 msgid "" "A variant of :class:`Queue`; retrieves entries in priority order (lowest " "first)." -msgstr "" +msgstr ":class:`Queue` 的變形;按優先順序取出條目 (最小的先取出)。" #: ../../library/asyncio-queue.rst:120 msgid "Entries are typically tuples of the form ``(priority_number, data)``." -msgstr "" +msgstr "條目通常是 ``(priority_number, data)`` 形式的 tuple(元組)。" #: ../../library/asyncio-queue.rst:125 msgid "LIFO Queue" -msgstr "" +msgstr "LIFO Queue" #: ../../library/asyncio-queue.rst:129 msgid "" "A variant of :class:`Queue` that retrieves most recently added entries first " "(last in, first out)." -msgstr "" +msgstr ":class:`Queue` 的變形,先取出最近新增的條目(後進先出)。" #: ../../library/asyncio-queue.rst:134 msgid "Exceptions" @@ -188,13 +212,15 @@ msgstr "例外" msgid "" "This exception is raised when the :meth:`~Queue.get_nowait` method is called " "on an empty queue." -msgstr "" +msgstr "當佇列為空的時候,呼叫 :meth:`~Queue.get_nowait` 方法會引發這個例外。" #: ../../library/asyncio-queue.rst:144 msgid "" "Exception raised when the :meth:`~Queue.put_nowait` method is called on a " "queue that has reached its *maxsize*." msgstr "" +"當佇列中條目數量已經達到它的 *maxsize* 時,呼叫 :meth:`~Queue.put_nowait` 方" +"法會引發這個例外。" #: ../../library/asyncio-queue.rst:149 msgid "Examples" @@ -203,4 +229,4 @@ msgstr "範例" #: ../../library/asyncio-queue.rst:153 msgid "" "Queues can be used to distribute workload between several concurrent tasks::" -msgstr "" +msgstr "佇列能被用於多個並行任務的工作分配:"