Repository navigation
Expand file tree
/
Copy pathasyncio-queue.po
More file actions
439 lines (390 loc) · 17.7 KB
/
Copy pathasyncio-queue.po
File metadata and controls
439 lines (390 loc) · 17.7 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# python-doc bot, 2025
# Inada Naoki <songofacandy@gmail.com>, 2026
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-25 17:19+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: Inada Naoki <songofacandy@gmail.com>, 2026\n"
"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\n"
"Plural-Forms: nplurals=1; plural=0;\n"
#: ../../library/asyncio-queue.rst:7
msgid "Queues"
msgstr "キュー"
#: ../../library/asyncio-queue.rst:9
msgid "**Source code:** :source:`Lib/asyncio/queues.py`"
msgstr "**ソースコード:** :source:`Lib/asyncio/queues.py`"
#: ../../library/asyncio-queue.rst:13
msgid ""
"asyncio queues are designed to be similar to classes of the :mod:`queue` "
"module. Although asyncio queues are not thread-safe, they are designed to "
"be used specifically in async/await code."
msgstr ""
"asyncio キューは :mod:`queue` モジュールのクラス群と同じ形になるように設計さ"
"れています。 asyncio キューはスレッドセーフではありませんが、それらは 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` "
"関数を使ってください。"
#: ../../library/asyncio-queue.rst:21
msgid "See also the `Examples`_ section below."
msgstr "下記の `使用例`_ 節も参照してください。"
#: ../../library/asyncio-queue.rst:24
msgid "Queue"
msgstr "Queue"
#: ../../library/asyncio-queue.rst:28
msgid "A first in, first out (FIFO) queue."
msgstr "先入れ先出し (FIFO) キューです。"
#: ../../library/asyncio-queue.rst:30
msgid ""
"If *maxsize* is less than or equal to zero, the queue size is infinite. If "
"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()`` は :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 "*loop* パラメータが削除されました。"
#: ../../library/asyncio-queue.rst:43
msgid "This class is :ref:`not thread safe <asyncio-multithreading>`."
msgstr ""
"このクラスは :ref:`スレッド安全ではありません <asyncio-multithreading>`。"
#: ../../library/asyncio-queue.rst:47
msgid "Number of items allowed in the queue."
msgstr "キューに追加できるアイテム数です。"
#: ../../library/asyncio-queue.rst:51
msgid "Return ``True`` if the queue is empty, ``False`` otherwise."
msgstr "キューが空ならば ``True`` を、そうでなければ ``False`` を返します。"
#: ../../library/asyncio-queue.rst:55
msgid "Return ``True`` if there are :attr:`maxsize` items in the queue."
msgstr "キューに要素が :attr:`maxsize` 個あれば ``True`` を返します。"
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:63
msgid ""
"Remove and return an item from the queue. If queue is empty, wait until an "
"item is available."
msgstr ""
"キューから要素を削除して返します。キューが空の場合項目が利用可能になるまで待"
"機します。"
msgid ""
"Raises :exc:`QueueShutDown` if the queue has been shut down and is empty, or "
"if the queue has been shut down immediately."
msgstr ""
"キューがシャットダウン済みで空の場合、または即時シャットダウンされた場合"
"は、:exc:`QueueShutDown` を送出します。"
msgid ""
"Return an item if one is immediately available, else raise :exc:`QueueEmpty`."
msgstr ""
"直ちに利用できる要素がある場合はその要素を返し、そうでなけれ"
"ば :exc:`QueueEmpty` を送出します。"
msgid ""
"Raises :exc:`QueueShutDown` if the queue has been shut down and is empty."
msgstr ""
"キューがシャットダウン済みで空の場合、:exc:`QueueShutDown` を送出します。"
#: ../../library/asyncio-queue.rst:79
msgid "Block until all items in the queue have been received and processed."
msgstr "キューにある全ての要素が取得され、処理されるまでブロックします。"
#: ../../library/asyncio-queue.rst:81
msgid ""
"The count of unfinished tasks goes up whenever an item is added to the "
"queue. The count goes down whenever a consumer coroutine "
"calls :meth:`task_done` to indicate that the item was retrieved and all work "
"on it is complete. When the count of unfinished tasks drops to "
"zero, :meth:`join` unblocks."
msgstr ""
"未完了のタスクのカウント値は、キューにアイテムが追加されるときは常に加算さ"
"れ、キューの要素を消費するコルーチンが要素を取り出し、処理を完了したことを通"
"知するために :meth:`task_done` を呼び出すと減算されます。未完了のタスクのカウ"
"ント値がゼロになると、 :meth:`join` のブロックは解除されます。"
#: ../../library/asyncio-queue.rst:90
msgid ""
"Put an item into the queue. If the queue is full, wait until a free slot is "
"available before adding the item."
msgstr ""
"要素をキューに入力します。キューが満杯の場合、要素を追加する前に空きスロット"
"が利用できるようになるまで待機します。"
msgid "Raises :exc:`QueueShutDown` if the queue has been shut down."
msgstr "キューがシャットダウン済みの場合、:exc:`QueueShutDown` を送出します。"
#: ../../library/asyncio-queue.rst:97
msgid "Put an item into the queue without blocking."
msgstr "ブロックせずにアイテムをキューに追加します。"
#: ../../library/asyncio-queue.rst:99
msgid "If no free slot is immediately available, raise :exc:`QueueFull`."
msgstr "直ちに利用できるスロットがない場合、:exc:`QueueFull` を送出します。"
#: ../../library/asyncio-queue.rst:105
msgid "Return the number of items in the queue."
msgstr "キュー内の要素数を返します。"
msgid "Put a :class:`Queue` instance into a shutdown mode."
msgstr ":class:`Queue` インスタンスをシャットダウンモードにします。"
msgid ""
"The queue can no longer grow. Future calls to :meth:`~Queue.put` "
"raise :exc:`QueueShutDown`. Currently blocked callers of :meth:`~Queue.put` "
"will be unblocked and will raise :exc:`QueueShutDown` in the formerly "
"awaiting task."
msgstr ""
"以後、キューに要素を追加できなくなります。\n"
":meth:`~Queue.put` を呼び出すと :exc:`QueueShutDown` を送出します。\n"
"すでに :meth:`~Queue.put` でブロックしている呼び出し元もブロックを解除され、"
"待機していたタスク内で :exc:`QueueShutDown` が送出されます。"
msgid ""
"If *immediate* is false (the default), the queue can be wound down normally "
"with :meth:`~Queue.get` calls to extract tasks that have already been loaded."
msgstr ""
"*immediate* が偽 (デフォルト) の場合、:meth:`~Queue.get` で投入済みのタスクを"
"取り出し、通常どおり処理しながらキューの使用を終了できます。"
msgid ""
"And if :meth:`~Queue.task_done` is called for each remaining task, a "
"pending :meth:`~Queue.join` will be unblocked normally."
msgstr ""
"残りのタスクそれぞれについて :meth:`~Queue.task_done` を呼び出せば、待機中"
"の :meth:`~Queue.join` も通常どおりブロックを解除されます。"
msgid ""
"Once the queue is empty, future calls to :meth:`~Queue.get` will "
"raise :exc:`QueueShutDown`."
msgstr ""
"キューが空になると、以後の :meth:`~Queue.get` は :exc:`QueueShutDown` を送出"
"します。"
msgid ""
"If *immediate* is true, the queue is terminated immediately. The queue is "
"drained to be completely empty and the count of unfinished tasks is reduced "
"by the number of tasks drained. If unfinished tasks is zero, callers "
"of :meth:`~Queue.join` are unblocked. Also, blocked callers "
"of :meth:`~Queue.get` are unblocked and will raise :exc:`QueueShutDown` "
"because the queue is empty."
msgstr ""
"*immediate* が真の場合、キューを即座に終了します。\n"
"キューからすべての要素を取り除いて空にし、取り除いたタスクの数だけ未完了タス"
"ク数を減らします。\n"
"未完了タスク数がゼロになると、:meth:`~Queue.join` の呼び出し元のブロックを解"
"除します。\n"
"また、:meth:`~Queue.get` でブロックしている呼び出し元もブロックを解除されます"
"が、キューが空なので :exc:`QueueShutDown` が送出されます。"
msgid ""
"Use caution when using :meth:`~Queue.join` with *immediate* set to true. "
"This unblocks the join even when no work has been done on the tasks, "
"violating the usual invariant for joining a queue."
msgstr ""
"*immediate* を真にして :meth:`~Queue.join` を使う場合は注意してください。\n"
"タスクを処理していなくても ``join()`` のブロックが解除されるため、通常の"
"キューの完了待ちで保証される条件が成り立たなくなります。"
msgid "Indicate that a formerly enqueued work item is complete."
msgstr "キューに投入されていた作業項目の処理が完了したことを通知します。"
msgid ""
"Used by queue consumers. For each :meth:`~Queue.get` used to fetch a work "
"item, a subsequent call to :meth:`task_done` tells the queue that the "
"processing on the work item is complete."
msgstr ""
"キューから作業を取り出す側が使います。\n"
":meth:`~Queue.get` で作業項目を取り出すたびに、処理後に :meth:`task_done` を"
"呼び出して、作業が完了したことをキューに伝えます。"
#: ../../library/asyncio-queue.rst:148
msgid ""
"If a :meth:`join` is currently blocking, it will resume when all items have "
"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` の呼び"
"出しを受信したとき) に再開します。"
msgid ""
"Raises :exc:`ValueError` if called more times than there were items placed "
"in the queue."
msgstr ""
"呼び出し回数がキューに追加されたアイテムの総数を超えると :exc:`ValueError` を"
"送出します。"
#: ../../library/asyncio-queue.rst:158
msgid "Priority Queue"
msgstr "優先度付きのキュー"
msgid ""
"A variant of :class:`Queue`; retrieves entries in priority order (lowest "
"first)."
msgstr ":class:`Queue` の一種で、優先度の値が小さい要素から取り出します。"
#: ../../library/asyncio-queue.rst:165
msgid "Entries are typically tuples of the form ``(priority_number, data)``."
msgstr "項目は典型的には ``(priority_number, data)`` 形式のタプルです。"
#: ../../library/asyncio-queue.rst:170
msgid "LIFO Queue"
msgstr "LIFO キュー"
#: ../../library/asyncio-queue.rst:174
msgid ""
"A variant of :class:`Queue` that retrieves most recently added entries first "
"(last in, first out)."
msgstr ""
":class:`Queue` の変種で、最後に追加された項目を最初に取り出します (後入れ先出"
"し、またはスタック)。"
#: ../../library/asyncio-queue.rst:179
msgid "Exceptions"
msgstr "例外"
#: ../../library/asyncio-queue.rst:183
msgid ""
"This exception is raised when the :meth:`~Queue.get_nowait` method is called "
"on an empty queue."
msgstr ""
"この例外は :meth:`~Queue.get_nowait` メソッドが空のキューに対して呼ばれたとき"
"に送出されます。"
#: ../../library/asyncio-queue.rst:189
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` メソッド"
"が 呼ばれたときに送出される例外です。"
msgid ""
"Exception raised "
"when :meth:`~Queue.put`, :meth:`~Queue.put_nowait`, :meth:`~Queue.get` "
"or :meth:`~Queue.get_nowait` is called on a queue which has been shut down."
msgstr ""
"シャットダウン済みのキューに対し"
"て :meth:`~Queue.put`、:meth:`~Queue.put_nowait`、:meth:`~Queue.get`、:meth:`~Queue.get_nowait` "
"を呼び出したときに送出される例外です。"
#: ../../library/asyncio-queue.rst:203
msgid "Examples"
msgstr "使用例"
#: ../../library/asyncio-queue.rst:207
msgid ""
"Queues can be used to distribute workload between several concurrent tasks::"
msgstr ""
"キューを使って、並行処理を行う複数のタスクにワークロードを分散させることがで"
"きます::"
msgid ""
"import asyncio\n"
"import random\n"
"import time\n"
"\n"
"\n"
"async def worker(name, queue):\n"
" while True:\n"
" # Get a \"work item\" out of the queue.\n"
" sleep_for = await queue.get()\n"
"\n"
" # Sleep for the \"sleep_for\" seconds.\n"
" await asyncio.sleep(sleep_for)\n"
"\n"
" # Notify the queue that the \"work item\" has been processed.\n"
" queue.task_done()\n"
"\n"
" print(f'{name} has slept for {sleep_for:.2f} seconds')\n"
"\n"
"\n"
"async def main():\n"
" # Create a queue that we will use to store our \"workload\".\n"
" queue = asyncio.Queue()\n"
"\n"
" # Generate random timings and put them into the queue.\n"
" total_sleep_time = 0\n"
" for _ in range(20):\n"
" sleep_for = random.uniform(0.05, 1.0)\n"
" total_sleep_time += sleep_for\n"
" queue.put_nowait(sleep_for)\n"
"\n"
" # Create three worker tasks to process the queue concurrently.\n"
" tasks = []\n"
" for i in range(3):\n"
" task = asyncio.create_task(worker(f'worker-{i}', queue))\n"
" tasks.append(task)\n"
"\n"
" # Wait until the queue is fully processed.\n"
" started_at = time.monotonic()\n"
" await queue.join()\n"
" total_slept_for = time.monotonic() - started_at\n"
"\n"
" # Cancel our worker tasks.\n"
" for task in tasks:\n"
" task.cancel()\n"
" # Wait until all worker tasks are cancelled.\n"
" await asyncio.gather(*tasks, return_exceptions=True)\n"
"\n"
" print('====')\n"
" print(f'3 workers slept in parallel for {total_slept_for:.2f} seconds')\n"
" print(f'total expected sleep time: {total_sleep_time:.2f} seconds')\n"
"\n"
"\n"
"asyncio.run(main())"
msgstr ""
"import asyncio\n"
"import random\n"
"import time\n"
"\n"
"\n"
"async def worker(name, queue):\n"
" while True:\n"
" # キューから作業項目を取り出す。\n"
" sleep_for = await queue.get()\n"
"\n"
" # sleep_for 秒スリープする。\n"
" await asyncio.sleep(sleep_for)\n"
"\n"
" # 作業項目の処理が完了したことをキューに通知する。\n"
" queue.task_done()\n"
"\n"
" print(f'{name} has slept for {sleep_for:.2f} seconds')\n"
"\n"
"\n"
"async def main():\n"
" # 作業を格納するキューを作成する。\n"
" queue = asyncio.Queue()\n"
"\n"
" # ランダムな待ち時間を生成してキューに追加する。\n"
" total_sleep_time = 0\n"
" for _ in range(20):\n"
" sleep_for = random.uniform(0.05, 1.0)\n"
" total_sleep_time += sleep_for\n"
" queue.put_nowait(sleep_for)\n"
"\n"
" # キューを並行して処理する三つのワーカータスクを作成する。\n"
" tasks = []\n"
" for i in range(3):\n"
" task = asyncio.create_task(worker(f'worker-{i}', queue))\n"
" tasks.append(task)\n"
"\n"
" # キューの全項目の処理が完了するまで待つ。\n"
" started_at = time.monotonic()\n"
" await queue.join()\n"
" total_slept_for = time.monotonic() - started_at\n"
"\n"
" # ワーカータスクをキャンセルする。\n"
" for task in tasks:\n"
" task.cancel()\n"
" # すべてのワーカータスクのキャンセルが完了するまで待つ。\n"
" await asyncio.gather(*tasks, return_exceptions=True)\n"
"\n"
" print('====')\n"
" print(f'3 workers slept in parallel for {total_slept_for:.2f} seconds')\n"
" print(f'total expected sleep time: {total_sleep_time:.2f} seconds')\n"
"\n"
"\n"
"asyncio.run(main())"