python-docs-ja/library/asyncio-queue.po at 3.15 · python/python-docs-ja · GitHub

Repository navigation

History

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

# SOME DESCRIPTIVE TITLE.

# 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"

"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"

"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"

"asyncio.run(main())"

msgstr ""

"import asyncio\n"

"import random\n"

"import time\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"

"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"

python-docs-ja/library/asyncio-queue.po at 3.15 · python/python-docs-ja · GitHub

Repository navigation

Expand file tree

Breadcrumbs

asyncio-queue.po

Latest commit

History

Breadcrumbs

asyncio-queue.po

File metadata and controls