Skip to content

Commit 350c065

Browse files
sync with cpython b587c54b
1 parent 7c5681c commit 350c065

6 files changed

Lines changed: 1782 additions & 1755 deletions

File tree

library/asyncio-queue.po

Lines changed: 43 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.14\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2025-12-17 17:02+0000\n"
11+
"POT-Creation-Date: 2026-07-12 00:29+0000\n"
1212
"PO-Revision-Date: 2022-02-20 18:34+0800\n"
1313
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -120,11 +120,17 @@ msgid ""
120120
"Return an item if one is immediately available, else raise :exc:`QueueEmpty`."
121121
msgstr "如果佇列內有值則立即回傳佇列中的元素,否則引發 :exc:`QueueEmpty`。"
122122

123-
#: ../../library/asyncio-queue.rst:77
123+
#: ../../library/asyncio-queue.rst:74
124+
#, fuzzy
125+
msgid ""
126+
"Raises :exc:`QueueShutDown` if the queue has been shut down and is empty."
127+
msgstr "如果佇列已經被關閉,則引發 :exc:`QueueShutDown`。"
128+
129+
#: ../../library/asyncio-queue.rst:79
124130
msgid "Block until all items in the queue have been received and processed."
125131
msgstr "持續阻塞直到佇列中所有的元素都被接收和處理完畢。"
126132

127-
#: ../../library/asyncio-queue.rst:79
133+
#: ../../library/asyncio-queue.rst:81
128134
msgid ""
129135
"The count of unfinished tasks goes up whenever an item is added to the "
130136
"queue. The count goes down whenever a consumer coroutine calls :meth:"
@@ -137,60 +143,60 @@ msgstr ""
137143
"成,未完成任務計數就會減少。當未完成計數降到零的時候,:meth:`join` 阻塞會被解"
138144
"除 (unblock)。"
139145

140-
#: ../../library/asyncio-queue.rst:88
146+
#: ../../library/asyncio-queue.rst:90
141147
msgid ""
142148
"Put an item into the queue. If the queue is full, wait until a free slot is "
143149
"available before adding the item."
144150
msgstr ""
145151
"將一個元素放進佇列。如果佇列滿了,在新增元素之前,會持續等待直到有空閒插槽 "
146152
"(free slot) 能被使用。"
147153

148-
#: ../../library/asyncio-queue.rst:91
154+
#: ../../library/asyncio-queue.rst:93 ../../library/asyncio-queue.rst:101
149155
msgid "Raises :exc:`QueueShutDown` if the queue has been shut down."
150156
msgstr "如果佇列已經被關閉,則引發 :exc:`QueueShutDown`。"
151157

152-
#: ../../library/asyncio-queue.rst:95
158+
#: ../../library/asyncio-queue.rst:97
153159
msgid "Put an item into the queue without blocking."
154160
msgstr "不阻塞地將一個元素放入佇列。"
155161

156-
#: ../../library/asyncio-queue.rst:97
162+
#: ../../library/asyncio-queue.rst:99
157163
msgid "If no free slot is immediately available, raise :exc:`QueueFull`."
158164
msgstr "如果沒有立即可用的空閒插槽,引發 :exc:`QueueFull`。"
159165

160-
#: ../../library/asyncio-queue.rst:101
166+
#: ../../library/asyncio-queue.rst:105
161167
msgid "Return the number of items in the queue."
162168
msgstr "回傳佇列中的元素數量。"
163169

164-
#: ../../library/asyncio-queue.rst:105
170+
#: ../../library/asyncio-queue.rst:109
165171
msgid "Put a :class:`Queue` instance into a shutdown mode."
166172
msgstr ""
167173

168-
#: ../../library/asyncio-queue.rst:107
174+
#: ../../library/asyncio-queue.rst:111
169175
msgid ""
170176
"The queue can no longer grow. Future calls to :meth:`~Queue.put` raise :exc:"
171177
"`QueueShutDown`. Currently blocked callers of :meth:`~Queue.put` will be "
172178
"unblocked and will raise :exc:`QueueShutDown` in the formerly awaiting task."
173179
msgstr ""
174180

175-
#: ../../library/asyncio-queue.rst:112
181+
#: ../../library/asyncio-queue.rst:116
176182
msgid ""
177183
"If *immediate* is false (the default), the queue can be wound down normally "
178184
"with :meth:`~Queue.get` calls to extract tasks that have already been loaded."
179185
msgstr ""
180186

181-
#: ../../library/asyncio-queue.rst:116
187+
#: ../../library/asyncio-queue.rst:120
182188
msgid ""
183189
"And if :meth:`~Queue.task_done` is called for each remaining task, a "
184190
"pending :meth:`~Queue.join` will be unblocked normally."
185191
msgstr ""
186192

187-
#: ../../library/asyncio-queue.rst:119
193+
#: ../../library/asyncio-queue.rst:123
188194
msgid ""
189195
"Once the queue is empty, future calls to :meth:`~Queue.get` will raise :exc:"
190196
"`QueueShutDown`."
191197
msgstr ""
192198

193-
#: ../../library/asyncio-queue.rst:122
199+
#: ../../library/asyncio-queue.rst:126
194200
msgid ""
195201
"If *immediate* is true, the queue is terminated immediately. The queue is "
196202
"drained to be completely empty and the count of unfinished tasks is reduced "
@@ -200,18 +206,18 @@ msgid ""
200206
"empty."
201207
msgstr ""
202208

203-
#: ../../library/asyncio-queue.rst:130
209+
#: ../../library/asyncio-queue.rst:134
204210
msgid ""
205211
"Use caution when using :meth:`~Queue.join` with *immediate* set to true. "
206212
"This unblocks the join even when no work has been done on the tasks, "
207213
"violating the usual invariant for joining a queue."
208214
msgstr ""
209215

210-
#: ../../library/asyncio-queue.rst:138
216+
#: ../../library/asyncio-queue.rst:142
211217
msgid "Indicate that a formerly enqueued work item is complete."
212218
msgstr "表示前面一個排隊的工作項目已經完成。"
213219

214-
#: ../../library/asyncio-queue.rst:140
220+
#: ../../library/asyncio-queue.rst:144
215221
msgid ""
216222
"Used by queue consumers. For each :meth:`~Queue.get` used to fetch a work "
217223
"item, a subsequent call to :meth:`task_done` tells the queue that the "
@@ -220,7 +226,7 @@ msgstr ""
220226
"由佇列消耗者使用。對於每個用於取得一個工作項目的 :meth:`~Queue.get`,接續的 :"
221227
"meth:`task_done` 呼叫會告訴佇列這個工作項目的處理已經完成。"
222228

223-
#: ../../library/asyncio-queue.rst:144
229+
#: ../../library/asyncio-queue.rst:148
224230
msgid ""
225231
"If a :meth:`join` is currently blocking, it will resume when all items have "
226232
"been processed (meaning that a :meth:`task_done` call was received for every "
@@ -229,70 +235,74 @@ msgstr ""
229235
"如果 :meth:`join` 目前正在阻塞,在所有項目都被處理後會解除阻塞(意味著每個"
230236
"以 :meth:`~Queue.put` 放進佇列的條目都會收到一個 :meth:`task_done`)。"
231237

232-
#: ../../library/asyncio-queue.rst:149
238+
#: ../../library/asyncio-queue.rst:153
233239
msgid ""
234240
"Raises :exc:`ValueError` if called more times than there were items placed "
235241
"in the queue."
236242
msgstr "如果被呼叫的次數多於放入佇列中的項目數量,將引發 :exc:`ValueError`。"
237243

238-
#: ../../library/asyncio-queue.rst:154
244+
#: ../../library/asyncio-queue.rst:158
239245
msgid "Priority Queue"
240246
msgstr "Priority Queue(優先佇列)"
241247

242-
#: ../../library/asyncio-queue.rst:158
248+
#: ../../library/asyncio-queue.rst:162
243249
msgid ""
244250
"A variant of :class:`Queue`; retrieves entries in priority order (lowest "
245251
"first)."
246252
msgstr ":class:`Queue` 的變形;按優先順序取出條目 (最小的先取出)。"
247253

248-
#: ../../library/asyncio-queue.rst:161
254+
#: ../../library/asyncio-queue.rst:165
249255
msgid "Entries are typically tuples of the form ``(priority_number, data)``."
250256
msgstr "條目通常是 ``(priority_number, data)`` 形式的 tuple(元組)。"
251257

252-
#: ../../library/asyncio-queue.rst:166
258+
#: ../../library/asyncio-queue.rst:170
253259
msgid "LIFO Queue"
254260
msgstr "LIFO Queue"
255261

256-
#: ../../library/asyncio-queue.rst:170
262+
#: ../../library/asyncio-queue.rst:174
257263
msgid ""
258264
"A variant of :class:`Queue` that retrieves most recently added entries first "
259265
"(last in, first out)."
260266
msgstr ":class:`Queue` 的變形,先取出最近新增的條目(後進先出)。"
261267

262-
#: ../../library/asyncio-queue.rst:175
268+
#: ../../library/asyncio-queue.rst:179
263269
msgid "Exceptions"
264270
msgstr "例外"
265271

266-
#: ../../library/asyncio-queue.rst:179
272+
#: ../../library/asyncio-queue.rst:183
267273
msgid ""
268274
"This exception is raised when the :meth:`~Queue.get_nowait` method is called "
269275
"on an empty queue."
270276
msgstr "當佇列為空的時候,呼叫 :meth:`~Queue.get_nowait` 方法會引發這個例外。"
271277

272-
#: ../../library/asyncio-queue.rst:185
278+
#: ../../library/asyncio-queue.rst:189
273279
msgid ""
274280
"Exception raised when the :meth:`~Queue.put_nowait` method is called on a "
275281
"queue that has reached its *maxsize*."
276282
msgstr ""
277283
"當佇列中條目數量已經達到它的 *maxsize* 時,呼叫 :meth:`~Queue.put_nowait` 方"
278284
"法會引發這個例外。"
279285

280-
#: ../../library/asyncio-queue.rst:191
286+
#: ../../library/asyncio-queue.rst:195
287+
#, fuzzy
281288
msgid ""
282-
"Exception raised when :meth:`~Queue.put` or :meth:`~Queue.get` is called on "
283-
"a queue which has been shut down."
289+
"Exception raised when :meth:`~Queue.put`, :meth:`~Queue.put_nowait`, :meth:"
290+
"`~Queue.get` or :meth:`~Queue.get_nowait` is called on a queue which has "
291+
"been shut down."
284292
msgstr ""
293+
"當佇列中條目數量已經達到它的 *maxsize* 時,呼叫 :meth:`~Queue.put_nowait` 方"
294+
"法會引發這個例外。"
285295

286-
#: ../../library/asyncio-queue.rst:198
296+
#: ../../library/asyncio-queue.rst:203
287297
msgid "Examples"
288298
msgstr "範例"
289299

290-
#: ../../library/asyncio-queue.rst:202
300+
#: ../../library/asyncio-queue.rst:207
291301
msgid ""
292302
"Queues can be used to distribute workload between several concurrent tasks::"
293303
msgstr "佇列能被用於多個並行任務的工作分配:"
294304

295-
#: ../../library/asyncio-queue.rst:205
305+
#: ../../library/asyncio-queue.rst:210
296306
msgid ""
297307
"import asyncio\n"
298308
"import random\n"

0 commit comments

Comments
 (0)