GeezerVisonThe World Wide Web, restored to 800 pixels of glory. |
| Home|About|Gaming cabinet|Archives|How it works|Starter sites |
GeezerVison is showing github.com — python-docs-ja/library/asyncio-eventloop.po at 3.13 · python/python-docs-ja Expand file tree/ Copy pathasyncio-eventloop.poMore file actions 3323 lines (2910 loc) · 147 KB / Copy pathasyncio-eventloop.poFile metadata and controls3323 lines (2910 loc) · 147 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 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 # 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: # tomo, 2021 # Tetsuo Koyama <[email protected]>, 2021 # Takeshi Nakazato, 2022 # Arihiro TAKASE, 2023 # souma987, 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-05-23 14:20+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: souma987, 2023\n" "Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/" "ja/)\n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../library/asyncio-eventloop.rst:8 msgid "Event Loop" msgstr "イベントループ" msgid "" "**Source code:** :source:`Lib/asyncio/events.py`, :source:`Lib/asyncio/" "base_events.py`" msgstr "" "**ソースコード:** :source:`Lib/asyncio/events.py`, :source:`Lib/asyncio/" "base_events.py`" #: ../../library/asyncio-eventloop.rst:16 msgid "Preface" msgstr "まえがき" #: ../../library/asyncio-eventloop.rst:17 msgid "" "The event loop is the core of every asyncio application. Event loops run " "asynchronous tasks and callbacks, perform network IO operations, and run " "subprocesses." msgstr "" "イベントループは全ての asyncio アプリケーションの中核をなす存在です。イベント" "ループは非同期タスクやコールバックを実行し、ネットワーク I/O を処理し、サブプ" "ロセスを実行します。" #: ../../library/asyncio-eventloop.rst:21 msgid "" "Application developers should typically use the high-level asyncio " "functions, such as :func:`asyncio.run`, and should rarely need to reference " "the loop object or call its methods. This section is intended mostly for " "authors of lower-level code, libraries, and frameworks, who need finer " "control over the event loop behavior." msgstr "" "アプリケーション開発者は通常 :func:`asyncio.run` のような高水準の ayncio 関数" "だけを利用し、ループオブジェクトを参照したり、ループオブジェクトのメソッドを" "呼び出したりすることはほとんどありません。この節は、イベントループの振る舞い" "に対して細かい調整が必要な、低水準のコード、ライブラリ、フレームワークの開発" "者向けです。" #: ../../library/asyncio-eventloop.rst:28 msgid "Obtaining the Event Loop" msgstr "イベントループの取得" #: ../../library/asyncio-eventloop.rst:29 msgid "" "The following low-level functions can be used to get, set, or create an " "event loop:" msgstr "以下の低水準関数はイベントループの取得、設定、生成するために使います:" #: ../../library/asyncio-eventloop.rst:34 msgid "Return the running event loop in the current OS thread." msgstr "現在の OS スレッドで実行中のイベントループを取得します。" msgid "Raise a :exc:`RuntimeError` if there is no running event loop." msgstr "実行中のイベントループがなければ :exc:`RuntimeError` を送出します。" msgid "This function can only be called from a coroutine or a callback." msgstr "この関数は、コルーチンまたはコールバックからのみ呼び出せます。" #: ../../library/asyncio-eventloop.rst:44 msgid "Get the current event loop." msgstr "現在のイベントループを取得します。" msgid "" "When called from a coroutine or a callback (e.g. scheduled with call_soon or " "similar API), this function will always return the running event loop." msgstr "" "コルーチンまたはコールバック (``call_soon()`` などの API でスケジュールしたも" "の) から呼び出すと、常に実行中のイベントループを返します。" msgid "" "If there is no running event loop set, the function will return the result " "of the ``get_event_loop_policy().get_event_loop()`` call." msgstr "" "実行中のイベントループがなければ、" "``get_event_loop_policy().get_event_loop()`` の呼び出し結果を返します。" #: ../../library/asyncio-eventloop.rst:53 msgid "" "Because this function has rather complex behavior (especially when custom " "event loop policies are in use), using the :func:`get_running_loop` function " "is preferred to :func:`get_event_loop` in coroutines and callbacks." msgstr "" "この関数の振る舞いは (特にイベントループポリシーをカスタマイズした場合) 複雑" "なため、コルーチンやコールバックでは :func:`get_event_loop` より" "も :func:`get_running_loop` を使うほうが好ましいと考えられます。" msgid "" "As noted above, consider using the higher-level :func:`asyncio.run` " "function, instead of using these lower level functions to manually create " "and close an event loop." msgstr "" "前述のとおり、これらの低水準関数でイベントループを手動で作成・クローズする代" "わりに、より高水準な :func:`asyncio.run` の使用を検討してください。" msgid "Raises a :exc:`RuntimeError` if there is no current event loop." msgstr "" "現在のイベントループがなければ :exc:`RuntimeError` を送出するようになりまし" "た。" msgid "" "The :mod:`!asyncio` policy system is deprecated and will be removed in " "Python 3.16; from there on, this function will return the current running " "event loop if present else it will return the loop set " "by :func:`set_event_loop`." msgstr "" ":mod:`!asyncio` のポリシーシステムは非推奨で、Python 3.16 で削除されます。\n" "それ以降、この関数は実行中のイベントループがあればそれを返し、なけれ" "ば :func:`set_event_loop` で設定したループを返します。" #: ../../library/asyncio-eventloop.rst:74 msgid "Set *loop* as the current event loop for the current OS thread." msgstr "*loop* を OS スレッドの現在のイベントループに設定します。" #: ../../library/asyncio-eventloop.rst:78 msgid "Create and return a new event loop object." msgstr "新しいイベントループオブジェクトを生成して返します。" #: ../../library/asyncio-eventloop.rst:80 msgid "" "Note that the behaviour of :func:`get_event_loop`, :func:`set_event_loop`, " "and :func:`new_event_loop` functions can be altered by :ref:`setting a " "custom event loop policy <asyncio-policies>`." msgstr "" ":func:`get_event_loop`, :func:`set_event_loop`, およ" "び :func:`new_event_loop` 関数の振る舞いは、 :ref:`カスタムイベントループポリ" "シーを設定する <asyncio-policies>` ことにより変更することができます。" #: ../../library/asyncio-eventloop.rst:86 msgid "Contents" msgstr "内容" #: ../../library/asyncio-eventloop.rst:87 msgid "This documentation page contains the following sections:" msgstr "このページは以下の節から構成されます:" #: ../../library/asyncio-eventloop.rst:89 msgid "" "The `Event Loop Methods`_ section is the reference documentation of the " "event loop APIs;" msgstr "" "`イベントループのメソッド`_ 節は、イベントループ API のリファレンスです。" msgid "" "The `Callback Handles`_ section documents the :class:`Handle` " "and :class:`TimerHandle` instances which are returned from scheduling " "methods such as :meth:`loop.call_soon` and :meth:`loop.call_later`;" msgstr "" "`コールバックハンドル`_ 節は :meth:`loop.call_soon` " "や :meth:`loop.call_later` などのスケジューリングメソッドが返" "す :class:`Handle` や :class:`TimerHandle` インスタンスについて解説していま" "す。" #: ../../library/asyncio-eventloop.rst:96 msgid "" "The `Server Objects`_ section documents types returned from event loop " "methods like :meth:`loop.create_server`;" msgstr "" "`サーバーオブジェクト`_ 節は :meth:`loop.create_server` のようなメソッドが返" "す型について解説しています。" #: ../../library/asyncio-eventloop.rst:99 msgid "" "The `Event Loop Implementations`_ section documents " "the :class:`SelectorEventLoop` and :class:`ProactorEventLoop` classes;" msgstr "" "`イベントループの実装`_ 節は :class:`SelectorEventLoop` " "と :class:`ProactorEventLoop` の2つのクラスについて解説しています。" #: ../../library/asyncio-eventloop.rst:102 msgid "" "The `Examples`_ section showcases how to work with some event loop APIs." msgstr "`使用例`_ 節ではイベントループ API の具体的な使い方を紹介しています。" #: ../../library/asyncio-eventloop.rst:109 msgid "Event Loop Methods" msgstr "イベントループのメソッド" #: ../../library/asyncio-eventloop.rst:111 msgid "Event loops have **low-level** APIs for the following:" msgstr "イベントループは以下の **低水準な** API を持っています:" #: ../../library/asyncio-eventloop.rst:119 msgid "Running and stopping the loop" msgstr "ループの開始と停止" msgid "Run until the *future* (an instance of :class:`Future`) has completed." msgstr "*future* (:class:`Future` のインスタンス) が完了するまで実行します。" #: ../../library/asyncio-eventloop.rst:126 msgid "" "If the argument is a :ref:`coroutine object <coroutine>` it is implicitly " "scheduled to run as a :class:`asyncio.Task`." msgstr "" "引数が :ref:`コルーチンオブジェクト <coroutine>` の場合、暗黙のうち" "に :class:`asyncio.Task` として実行されるようにスケジュールされます。" #: ../../library/asyncio-eventloop.rst:129 msgid "Return the Future's result or raise its exception." msgstr "Future の結果を返すか、例外を送出します。" #: ../../library/asyncio-eventloop.rst:133 msgid "Run the event loop until :meth:`stop` is called." msgstr ":meth:`stop` が呼び出されるまでイベントループを実行します。" #: ../../library/asyncio-eventloop.rst:135 msgid "" "If :meth:`stop` is called before :meth:`run_forever` is called, the loop " "will poll the I/O selector once with a timeout of zero, run all callbacks " "scheduled in response to I/O events (and those that were already scheduled), " "and then exit." msgstr "" ":meth:`run_forever` メソッドが呼ばれるより前に :meth:`stop` メソッドが呼ばれ" "た場合、イベントループはタイムアウトをゼロにして一度だけ I/O セレクタの問い合" "わせ処理を行い、 I/O イベントに対してスケジュールされた全てのコールバック (お" "よび既にスケジュール済みのコールバック) を実行したのち、終了します。" #: ../../library/asyncio-eventloop.rst:140 msgid "" "If :meth:`stop` is called while :meth:`run_forever` is running, the loop " "will run the current batch of callbacks and then exit. Note that new " "callbacks scheduled by callbacks will not run in this case; instead, they " "will run the next time :meth:`run_forever` or :meth:`run_until_complete` is " "called." msgstr "" ":meth:`run_forever` メソッドを実行中に :meth:`stop` メソッドが呼び出された場" "合、イベントループは現在処理されているすべてのコールバックを実行してから終了" "します。 この場合、コールバックにより新たにスケジュールされるコールバックは実" "行されないことに注意してください; これら新たにスケジュールされたコールバック" "は、次に :meth:`run_forever` または :meth:`run_until_complete` が呼び出された" "ときに実行されます。" #: ../../library/asyncio-eventloop.rst:148 msgid "Stop the event loop." msgstr "イベントループを停止します。" #: ../../library/asyncio-eventloop.rst:152 msgid "Return ``True`` if the event loop is currently running." msgstr "イベントループが現在実行中の場合 ``True`` を返します。" #: ../../library/asyncio-eventloop.rst:156 msgid "Return ``True`` if the event loop was closed." msgstr "イベントループが閉じられていた場合 ``True`` を返します。" #: ../../library/asyncio-eventloop.rst:160 msgid "Close the event loop." msgstr "イベントループをクローズします。" #: ../../library/asyncio-eventloop.rst:162 msgid "" "The loop must not be running when this function is called. Any pending " "callbacks will be discarded." msgstr "" "この関数が呼び出される時点で、イベントループが実行中であってはいけません。保" "留中のコールバックはすべて破棄されます。" #: ../../library/asyncio-eventloop.rst:165 msgid "" "This method clears all queues and shuts down the executor, but does not wait " "for the executor to finish." msgstr "" "このメソッドは全てのキューをクリアし、エグゼキューターが実行完了するのを待た" "ずにシャットダウンします。" #: ../../library/asyncio-eventloop.rst:168 msgid "" "This method is idempotent and irreversible. No other methods should be " "called after the event loop is closed." msgstr "" "このメソッドはべき等 (何回実行しても結果は同じ) であり取り消せません。イベン" "トループがクローズされた後、他のいかなるメソッドも呼び出すべきではありませ" "ん。" #: ../../library/asyncio-eventloop.rst:174 msgid "" "Schedule all currently open :term:`asynchronous generator` objects to close " "with an :meth:`~agen.aclose` call. After calling this method, the event " "loop will issue a warning if a new asynchronous generator is iterated. This " "should be used to reliably finalize all scheduled asynchronous generators." msgstr "" "現在オープンになっているすべての :term:`asynchronous generator` (非同期ジェネ" "レータ) オブジェクトをスケジュールし、 :meth:`~agen.aclose` メソッドを呼び出" "すことでそれらをクローズします。 このメソッドの呼び出し後に新しい非同期ジェネ" "レータがイテレートされると、イベントループは警告を発します。このメソッドはス" "ケジュールされたすべての非同期ジェネレータの終了処理を確実に行うために使用す" "べきです。" #: ../../library/asyncio-eventloop.rst:180 msgid "" "Note that there is no need to call this function when :func:`asyncio.run` is " "used." msgstr ":func:`asyncio.run` を使った場合はこの関数を呼び出す必要はありません。" #: ../../library/asyncio-eventloop.rst:183 #: ../../library/asyncio-eventloop.rst:1336 #: ../../library/asyncio-eventloop.rst:1792 msgid "Example::" msgstr "以下はプログラム例です::" msgid "" "try:\n" " loop.run_forever()\n" "finally:\n" " loop.run_until_complete(loop.shutdown_asyncgens())\n" " loop.close()" msgstr "" "try:\n" " loop.run_forever()\n" "finally:\n" " loop.run_until_complete(loop.shutdown_asyncgens())\n" " loop.close()" msgid "" "Schedule the closure of the default executor and wait for it to join all of " "the threads in the :class:`~concurrent.futures.ThreadPoolExecutor`. Once " "this method has been called, using the default executor " "with :meth:`loop.run_in_executor` will raise a :exc:`RuntimeError`." msgstr "" "デフォルトの Executor の終了をスケジュール" "し、:class:`~concurrent.futures.ThreadPoolExecutor` のすべてのスレッドの終了" "を待ちます。\n" "このメソッドを呼び出した後で :meth:`loop.run_in_executor` によりデフォルトの " "Executor を使うと、:exc:`RuntimeError` が送出されます。" msgid "" "The *timeout* parameter specifies the amount of time (in :class:`float` " "seconds) the executor will be given to finish joining. With the default, " "``None``, the executor is allowed an unlimited amount of time." msgstr "" "*timeout* は、Executor のスレッドの終了を待つ制限時間を秒単位" "の :class:`float` で指定します。\n" "デフォルトの ``None`` では、待ち時間に制限はありません。" msgid "" "If the *timeout* is reached, a :exc:`RuntimeWarning` is emitted and the " "default executor is terminated without waiting for its threads to finish " "joining." msgstr "" "*timeout* に達すると :exc:`RuntimeWarning` を出し、スレッドの終了を待たずにデ" "フォルトの Executor の終了処理を行います。" msgid "" "Do not call this method when using :func:`asyncio.run`, as the latter " "handles default executor shutdown automatically." msgstr "" ":func:`asyncio.run` はデフォルトの Executor の終了処理を自動的に行うため、こ" "れを使う場合はこのメソッドを呼び出さないでください。" #: ../../library/asyncio-eventloop.rst:218 msgid "Added the *timeout* parameter." msgstr "*timeout* 引数が追加されました。" #: ../../library/asyncio-eventloop.rst:222 msgid "Scheduling callbacks" msgstr "コールバックのスケジューリング" #: ../../library/asyncio-eventloop.rst:226 msgid "" "Schedule the *callback* :term:`callback` to be called with *args* arguments " "at the next iteration of the event loop." msgstr "" "イベントループの次のイテレーションで *callback* に指定したコールバック " "(:term:`callback`) を *args* 引数で呼び出すようにスケジュールします。" #: ../../library/asyncio-eventloop.rst:229 msgid "" "Return an instance of :class:`asyncio.Handle`, which can be used later to " "cancel the callback." msgstr "" ":class:`asyncio.Handle` のインスタンスを返します。このインスタンスを使ってス" "ケジュールしたコールバックをキャンセルすることができます。" #: ../../library/asyncio-eventloop.rst:232 msgid "" "Callbacks are called in the order in which they are registered. Each " "callback will be called exactly once." msgstr "" "コールバックは登録された順に呼び出されます。各コールバックは厳密に1回だけ呼び" "出されます。" msgid "" "The optional keyword-only *context* argument specifies a " "custom :class:`contextvars.Context` for the *callback* to run in. Callbacks " "use the current context when no *context* is provided." msgstr "" "省略可能なキーワード専用引数 *context* には、*callback* の実行に使" "う :class:`contextvars.Context` を指定します。\n" "*context* を指定しなければ、現在のコンテキストを使います。" msgid "Unlike :meth:`call_soon_threadsafe`, this method is not thread-safe." msgstr "" ":meth:`call_soon_threadsafe` とは異なり、このメソッドはスレッドセーフではあり" "ません。" msgid "" "A thread-safe variant of :meth:`call_soon`. When scheduling callbacks from " "another thread, this function *must* be used, since :meth:`call_soon` is not " "thread-safe." msgstr "" ":meth:`call_soon` のスレッドセーフな版です。\n" ":meth:`call_soon` はスレッドセーフではないため、別のスレッドからコールバック" "をスケジュールする場合は *必ず* この関数を使ってください。" msgid "" "This function is safe to be called from a reentrant context or signal " "handler, however, it is not safe or fruitful to use the returned handle in " "such contexts." msgstr "" "この関数は、再入可能なコンテキストやシグナルハンドラーから安全に呼び出せま" "す。\n" "ただし、そのようなコンテキストで返されたハンドルを使うことは、安全でも有用で" "もありません。" #: ../../library/asyncio-eventloop.rst:250 msgid "" "Raises :exc:`RuntimeError` if called on a loop that's been closed. This can " "happen on a secondary thread when the main application is shutting down." msgstr "" "すでにクローズされたイベントループに対してこのメソッドが呼び出された場" "合 :exc:`RuntimeError` 例外を送出します。これはメインアプリケーションが終了し" "ているにもかかわらずセカンダリスレッドでメソッドが呼び出されるといった場合に" "起こりえます。" #: ../../library/asyncio-eventloop.rst:254 msgid "" "See the :ref:`concurrency and multithreading <asyncio-multithreading>` " "section of the documentation." msgstr "" "このドキュメントの :ref:`asyncio-multithreading` 節を参照してください。" #: ../../library/asyncio-eventloop.rst:257 #: ../../library/asyncio-eventloop.rst:307 #: ../../library/asyncio-eventloop.rst:327 msgid "" "The *context* keyword-only parameter was added. See :pep:`567` for more " "details." msgstr "" "キーワード引数 *context* が追加されました。詳細は :pep:`567` を参照してくださ" "い。" #: ../../library/asyncio-eventloop.rst:265 msgid "" "Most :mod:`asyncio` scheduling functions don't allow passing keyword " "arguments. To do that, use :func:`functools.partial`::" msgstr "" "ほとんどの :mod:`asyncio` モジュールのスケジューリング関数は、キーワード引数" "をコールバックに渡すことを許していません。キーワード引数を渡すために" "は :func:`functools.partial` を使ってください:" msgid "" "# will schedule \"print(\"Hello\", flush=True)\"\n" "loop.call_soon(\n" " functools.partial(print, \"Hello\", flush=True))" msgstr "" "# print(\"Hello\", flush=True) をスケジュールする\n" "loop.call_soon(\n" " functools.partial(print, \"Hello\", flush=True))" #: ../../library/asyncio-eventloop.rst:272 msgid "" "Using partial objects is usually more convenient than using lambdas, as " "asyncio can render partial objects better in debug and error messages." msgstr "" "asyncio は partial オブジェクトのデバッグメッセージやエラーメッセージをよりよ" "く可視化することができるため、通常はラムダ式よりも partial オブジェクトを使う" "方が便利です。" #: ../../library/asyncio-eventloop.rst:280 msgid "Scheduling delayed callbacks" msgstr "遅延コールバックのスケジューリング" #: ../../library/asyncio-eventloop.rst:282 msgid "" "Event loop provides mechanisms to schedule callback functions to be called " "at some point in the future. Event loop uses monotonic clocks to track time." msgstr "" "イベントループは、コールバック関数を未来のある時点で呼び出されるようにスケ" "ジュールする仕組みを提供します。イベントループは時刻が戻らない単調な時計 " "(monotonic clock) を使って時刻を追跡します。" #: ../../library/asyncio-eventloop.rst:289 msgid "" "Schedule *callback* to be called after the given *delay* number of seconds " "(can be either an int or a float)." msgstr "" "*delay* 秒経過後にコールバック関数 *callback* を呼び出すようにスケジュールし" "ます。 *delay* には整数または浮動小数点数を指定します。" #: ../../library/asyncio-eventloop.rst:292 #: ../../library/asyncio-eventloop.rst:324 msgid "" "An instance of :class:`asyncio.TimerHandle` is returned which can be used to " "cancel the callback." msgstr "" ":class:`asyncio.TimerHandle` のインスタンスを返します。このインスタンスを使っ" "てスケジュールしたコールバックをキャンセルすることができます。" #: ../../library/asyncio-eventloop.rst:295 msgid "" "*callback* will be called exactly once. If two callbacks are scheduled for " "exactly the same time, the order in which they are called is undefined." msgstr "" "*callback* は厳密に一度だけ呼び出されます。2つのコールバックが完全に同じ時間" "にスケジュールされた場合、呼び出しの順序は未定義です。" #: ../../library/asyncio-eventloop.rst:299 msgid "" "The optional positional *args* will be passed to the callback when it is " "called. If you want the callback to be called with keyword arguments " "use :func:`functools.partial`." msgstr "" "オプションの位置引数 *args* はコールバックが呼び出されるときに位置引数として" "渡されます。キーワード引数を指定してコールバックを呼び出したい場合" "は :func:`functools.partial` を使用してください。" #: ../../library/asyncio-eventloop.rst:303 msgid "" "An optional keyword-only *context* argument allows specifying a " "custom :class:`contextvars.Context` for the *callback* to run in. The " "current context is used when no *context* is provided." msgstr "" "オプションのキーワード引数 *context* を使って、コールバック*callback* を実行" "する際のコンテキスト :class:`contextvars.Context` を設定することができます。" "コンテキスト *context* が指定されない場合は現在のコンテキストが使われます。" #: ../../library/asyncio-eventloop.rst:311 msgid "" "In Python 3.7 and earlier with the default event loop implementation, the " "*delay* could not exceed one day. This has been fixed in Python 3.8." msgstr "" "Python 3.7 またはそれ以前のバージョンでは、デフォルトイベントループの実装を利" "用した場合に遅延時間 *delay* が1日を超えることができませんでした。この問題は " "Python 3.8 で修正されました。" #: ../../library/asyncio-eventloop.rst:318 msgid "" "Schedule *callback* to be called at the given absolute timestamp *when* (an " "int or a float), using the same time reference as :meth:`loop.time`." msgstr "" "絶対値の時刻 *when* (整数または浮動小数点数) にコールバックを呼び出すようにス" "ケジュールします。 :meth:`loop.time` と同じ参照時刻を使用します。" #: ../../library/asyncio-eventloop.rst:322 msgid "This method's behavior is the same as :meth:`call_later`." msgstr "このメソッドの振る舞いは :meth:`call_later` と同じです。" #: ../../library/asyncio-eventloop.rst:331 msgid "" "In Python 3.7 and earlier with the default event loop implementation, the " "difference between *when* and the current time could not exceed one day. " "This has been fixed in Python 3.8." msgstr "" "Python 3.7 またはそれ以前のバージョンでは、デフォルトイベントループの実装を利" "用した場合に現在の時刻と *when* との差が1日を超えることができませんでした。こ" "の問題は Python 3.8 で修正されました。" #: ../../library/asyncio-eventloop.rst:338 msgid "" "Return the current time, as a :class:`float` value, according to the event " "loop's internal monotonic clock." msgstr "" "現在の時刻を :class:`float` 値で返します。時刻はイベントループが内部で参照し" "ている時刻が戻らない単調な時計 (monotonic clock) に従います。" #: ../../library/asyncio-eventloop.rst:342 msgid "" "In Python 3.7 and earlier timeouts (relative *delay* or absolute *when*) " "should not exceed one day. This has been fixed in Python 3.8." msgstr "" "Python 3.7 またはそれ以前のバージョンでは、タイムアウト (相対値 *delay* もし" "くは絶対値 *when*) は1日を超えることができませんでした。この問題は Python " "3.8 で修正されました。" #: ../../library/asyncio-eventloop.rst:348 msgid "The :func:`asyncio.sleep` function." msgstr "関数 :func:`asyncio.sleep`。" #: ../../library/asyncio-eventloop.rst:352 msgid "Creating Futures and Tasks" msgstr "フューチャーとタスクの生成" #: ../../library/asyncio-eventloop.rst:356 msgid "Create an :class:`asyncio.Future` object attached to the event loop." msgstr "" "イベントループに接続した :class:`asyncio.Future` オブジェクトを生成します。" msgid "" "This is the preferred way to create Futures in asyncio. This lets third-" "party event loops provide alternative implementations of the Future object " "(with better performance or instrumentation)." msgstr "" "asyncio でフューチャーオブジェクトを作成するために推奨される方法です。このメ" "ソッドにより、サードパーティ製のイベントループがFutures クラスの(パフォーマン" "スや計測方法が優れた) 代替実装を提供することを可能にします。" #: ../../library/asyncio-eventloop.rst:366 msgid "" "Schedule the execution of :ref:`coroutine <coroutine>` *coro*. Return " "a :class:`Task` object." msgstr "" ":ref:`コルーチン <coroutine>` *coro* の実行をスケジュールしま" "す。 :class:`Task` オブジェクトを返します。" #: ../../library/asyncio-eventloop.rst:369 msgid "" "Third-party event loops can use their own subclass of :class:`Task` for " "interoperability. In this case, the result type is a subclass " "of :class:`Task`." msgstr "" "サードパーティのイベントループは相互運用のための自身の :class:`Task` のサブク" "ラスを使用できます。この場合、結果は :class:`Task` のサブクラスになります。" msgid "" "The full function signature is largely the same as that of the :class:`Task` " "constructor (or factory) - all of the keyword arguments to this function are " "passed through to that interface." msgstr "" "関数のシグネチャ全体は :class:`Task` のコンストラクター (またはファクトリー) " "とほぼ同じです。\n" "この関数に渡したキーワード引数はすべて、そのコンストラクターやファクトリーに" "渡されます。" #: ../../library/asyncio-eventloop.rst:377 msgid "" "If the *name* argument is provided and not ``None``, it is set as the name " "of the task using :meth:`Task.set_name`." msgstr "" "*name* 引数が指定され、値が ``None`` でない場合、 :meth:`Task.set_name` メ" "ソッドにより *name* がタスクの名前として設定されます。" #: ../../library/asyncio-eventloop.rst:380 msgid "" "An optional keyword-only *context* argument allows specifying a " "custom :class:`contextvars.Context` for the *coro* to run in. The current " "context copy is created when no *context* is provided." msgstr "" "省略可能なキーワード引数 *context* によって、*coro* を実行するためのカスタム" "の :class:`contextvars.Context` を指定できます。*context* が省略された場合、" "現在のコンテキストのコピーが作成されます。" msgid "" "An optional keyword-only *eager_start* argument allows specifying if the " "task should execute eagerly during the call to create_task, or be scheduled " "later. If *eager_start* is not passed the mode set " "by :meth:`loop.set_task_factory` will be used." msgstr "" "省略可能なキーワード専用引数 *eager_start* では、``create_task()`` の呼び出し" "中にタスクの実行を即座に開始するか、後で実行するようにスケジュールするかを指" "定できます。\n" "*eager_start* を渡さない場合は :meth:`loop.set_task_factory` で設定したモード" "を使います。" #: ../../library/asyncio-eventloop.rst:389 msgid "Added the *name* parameter." msgstr "*name* パラメータを追加しました。" #: ../../library/asyncio-eventloop.rst:392 msgid "Added the *context* parameter." msgstr "*context* パラメータを追加しました。" msgid "" "Added ``kwargs`` which passes on arbitrary extra parameters, including " "``name`` and ``context``." msgstr "" "``name`` と ``context`` を含む任意の追加パラメーターを渡す ``kwargs`` が追加" "されました。" msgid "" "Rolled back the change that passes on *name* and *context* (if it is None), " "while still passing on other arbitrary keyword arguments (to avoid breaking " "backwards compatibility with 3.13.3)." msgstr "" "*name* と、値が ``None`` の場合の *context* を渡す変更を取り消しました。\n" "それ以外の任意のキーワード引数は、3.13.3 との後方互換性を保つため、引き続き渡" "されます。" msgid "" "All *kwargs* are now passed on. The *eager_start* parameter works with eager " "task factories." msgstr "" "すべての *kwargs* を渡すようになりました。\n" "*eager_start* パラメーターは、タスクを即座に実行するファクトリーで機能しま" "す。" #: ../../library/asyncio-eventloop.rst:407 msgid "Set a task factory that will be used by :meth:`loop.create_task`." msgstr ":meth:`loop.create_task` が使用するタスクファクトリーを設定します。" msgid "" "If *factory* is ``None`` the default task factory will be set. Otherwise, " "*factory* must be a *callable* with the signature matching ``(loop, coro, " "**kwargs)``, where *loop* is a reference to the active event loop, and " "*coro* is a coroutine object. The callable must pass on all *kwargs*, and " "return a :class:`asyncio.Task`-compatible object." msgstr "" "*factory* が ``None`` の場合は、デフォルトのタスクファクトリーを設定しま" "す。\n" "それ以外の場合、*factory* はシグネチャが ``(loop, coro, **kwargs)`` に対応す" "る *呼び出し可能オブジェクト* でなければなりません。\n" "ここで *loop* は使用するイベントループへの参照、*coro* はコルーチンオブジェク" "トです。\n" "この呼び出し可能オブジェクトは、すべての *kwargs* を呼び出し先に渡" "し、:class:`asyncio.Task` と互換性のあるオブジェクトを返す必要があります。" msgid "Required that all *kwargs* are passed on to :class:`asyncio.Task`." msgstr "" "すべての *kwargs* を :class:`asyncio.Task` に渡すことが必須になりました。" msgid "" "*name* is no longer passed to task factories. *context* is no longer passed " "to task factories if it is ``None``." msgstr "" "*name* をタスクファクトリーに渡さなくなりました。\n" "*context* も、値が ``None`` の場合は渡さなくなりました。" msgid "" "*name* and *context* are now unconditionally passed on to task factories " "again." msgstr "" "*name* と *context* を、再び無条件にタスクファクトリーに渡すようになりまし" "た。" #: ../../library/asyncio-eventloop.rst:428 msgid "Return a task factory or ``None`` if the default one is in use." msgstr "" "タスクファクトリを返します。デフォルトのタスクファクトリを使用中の場合は " "``None`` を返します。" #: ../../library/asyncio-eventloop.rst:432 msgid "Opening network connections" msgstr "ネットワーク接続の確立" #: ../../library/asyncio-eventloop.rst:444 msgid "" "Open a streaming transport connection to a given address specified by *host* " "and *port*." msgstr "" "*host* と *port* で指定されたアドレスとのストリーミングトランスポート接続を" "オープンします。" #: ../../library/asyncio-eventloop.rst:447 msgid "" "The socket family can be either :py:const:`~socket.AF_INET` " "or :py:const:`~socket.AF_INET6` depending on *host* (or the *family* " "argument, if provided)." msgstr "" "ソケットファミリーは *host* (または *family* 引数が与えられた場合は " "*family*) に依存し、 :py:const:`~socket.AF_INET` " "か :py:const:`~socket.AF_INET6` のいずれかを指定します。" #: ../../library/asyncio-eventloop.rst:451 msgid "The socket type will be :py:const:`~socket.SOCK_STREAM`." msgstr "ソケットタイプは :py:const:`~socket.SOCK_STREAM` になります。" #: ../../library/asyncio-eventloop.rst:453 #: ../../library/asyncio-eventloop.rst:1246 #: ../../library/asyncio-eventloop.rst:1263 msgid "" "*protocol_factory* must be a callable returning an :ref:`asyncio protocol " "<asyncio-protocol>` implementation." msgstr "" "*protocol_factory* は :ref:`asyncio プロトコル <asyncio-protocol>` の実装を返" "す呼び出し可能オブジェクトでなければなりません。" #: ../../library/asyncio-eventloop.rst:456 msgid "" "This method will try to establish the connection in the background. When " "successful, it returns a ``(transport, protocol)`` pair." msgstr "" "このメソッドはバックグラウンドで接続の確立を試みます。成功した場合、メソッド" "は ``(transport, protocol)`` のペアを返します。" #: ../../library/asyncio-eventloop.rst:459 msgid "The chronological synopsis of the underlying operation is as follows:" msgstr "時系列での下層処理の概要は以下のとおりです:" #: ../../library/asyncio-eventloop.rst:461 msgid "" "The connection is established and a :ref:`transport <asyncio-transport>` is " "created for it." msgstr "" "接続を確立し、その接続に対する :ref:`トランスポート <asyncio-transport>` が生" "成されます。" #: ../../library/asyncio-eventloop.rst:464 msgid "" "*protocol_factory* is called without arguments and is expected to return " "a :ref:`protocol <asyncio-protocol>` instance." msgstr "" "*protocol_factory* が引数なしで呼び出され、ファクトリが :ref:`プロトコル " "<asyncio-protocol>` インスタンスを返すよう要求します。" #: ../../library/asyncio-eventloop.rst:467 msgid "" "The protocol instance is coupled with the transport by calling " "its :meth:`~BaseProtocol.connection_made` method." msgstr "" "プロトコルインスタンスが :meth:`~BaseProtocol.connection_made` メソッドを呼び" "出すことにより、トランスポートと紐付けられます。" #: ../../library/asyncio-eventloop.rst:470 msgid "A ``(transport, protocol)`` tuple is returned on success." msgstr "成功すると ``(transport, protocol)`` タプルが返されます。" #: ../../library/asyncio-eventloop.rst:472 msgid "" "The created transport is an implementation-dependent bidirectional stream." msgstr "作成されたトランスポートは実装依存の双方向ストリームです。" #: ../../library/asyncio-eventloop.rst:475 #: ../../library/asyncio-eventloop.rst:608 msgid "Other arguments:" msgstr "その他の引数:" #: ../../library/asyncio-eventloop.rst:477 msgid "" "*ssl*: if given and not false, a SSL/TLS transport is created (by default a " "plain TCP transport is created). If *ssl* is a :class:`ssl.SSLContext` " "object, this context is used to create the transport; if *ssl* " "is :const:`True`, a default context returned " "from :func:`ssl.create_default_context` is used." msgstr "" "*ssl*: 偽値以外が与えられた場合、SSL/TLS トランスポートが作成されます (デフォ" "ルトでは暗号化なしの TCP トランスポートが作成されます)。 *ssl* " "が :class:`ssl.SSLContext` オブジェクトの場合、このコンテキストがトランスポー" "トを作成するために使用されます; *ssl* が :const:`True` の場" "合、 :func:`ssl.create_default_context` が返すデフォルトのコンテキストが使わ" "れます。" #: ../../library/asyncio-eventloop.rst:483 msgid ":ref:`SSL/TLS security considerations <ssl-security>`" msgstr ":ref:`SSL/TLS セキュリティについての考察 <ssl-security>`" #: ../../library/asyncio-eventloop.rst:485 msgid "" "*server_hostname* sets or overrides the hostname that the target server's " "certificate will be matched against. Should only be passed if *ssl* is not " "``None``. By default the value of the *host* argument is used. If *host* " "is empty, there is no default and you must pass a value for " "*server_hostname*. If *server_hostname* is an empty string, hostname " "matching is disabled (which is a serious security risk, allowing for " "potential man-in-the-middle attacks)." msgstr "" "*server_hostname* は対象サーバーの証明書との一致を確認するためのホスト名を設" "定または上書きします。この引数は *ssl* が ``None`` でない場合のみ設定すべきで" "す。デフォルトでは *host* に指定したサーバー名が使用されます。 *host* が空の" "文字列の場合のデフォルト値は設定されていません。その場合、 *server_hostname* " "を必ず指定してください。 *server_hostname* も空の文字列の場合は、ホスト名の一" "致確認は行われません (これは深刻なセキュリティリスクであり、中間者攻撃を受け" "る可能性があります)。" msgid "" "*family*, *proto*, *flags* are the optional address family, protocol and " "flags to be passed through to getaddrinfo() for *host* resolution. If given, " "these should all be integers from the corresponding :mod:`socket` module " "constants." msgstr "" "*family*、*proto*、*flags* は省略可能な引数で、それぞれアドレスファミリー、プ" "ロトコル、フラグを指定します。\n" "*host* の名前解決のために ``getaddrinfo()`` に渡されます。\n" "指定する場合は、:mod:`socket` モジュールの対応する整数定数を使ってください。" #: ../../library/asyncio-eventloop.rst:498 msgid "" "*happy_eyeballs_delay*, if given, enables Happy Eyeballs for this " "connection. It should be a floating-point number representing the amount of " "time in seconds to wait for a connection attempt to complete, before " "starting the next attempt in parallel. This is the \"Connection Attempt " "Delay\" as defined in :rfc:`8305`. A sensible default value recommended by " "the RFC is ``0.25`` (250 milliseconds)." msgstr "" "*happy_eyeballs_delay* が設定されると、この接続に対して Happy Eyeballs が有効" "化されます。設定する値は浮動小数点数であり、次の接続試行を開始する前に、現在" "の接続試行が完了するのを待つ時間を秒単位で表現します。この値は :rfc:`8305` で" "定義されている \"接続試行遅延\" に相当します。RFC で推奨されている実用的なデ" "フォルト値は ``0.25`` (250 ミリ秒) です。" #: ../../library/asyncio-eventloop.rst:506 msgid "" "*interleave* controls address reordering when a host name resolves to " "multiple IP addresses. If ``0`` or unspecified, no reordering is done, and " "addresses are tried in the order returned by :meth:`getaddrinfo`. If a " "positive integer is specified, the addresses are interleaved by address " "family, and the given integer is interpreted as \"First Address Family " "Count\" as defined in :rfc:`8305`. The default is ``0`` if " "*happy_eyeballs_delay* is not specified, and ``1`` if it is." msgstr "" "*interleave* はホスト名が複数の IP アドレスに名前解決される場合のアドレスの並" "べ替えを制御します。 ``0`` または未指定の場合並べ替えは行われ" "ず、 :meth:`getaddrinfo` が返す順番にしたがってアドレスへの接続を試行します。" "正の整数が指定されると、アドレスはアドレスファミリに応じてインターリーブされ" "ます。このとき、与えられた整数は :rfc:`8305` で定義される \"最初のアドレス" "ファミリカウント (First Address Family Count)\" として解釈されます。デフォル" "ト値は、 *happy_eyeballs_delay* が指定されない場合は ``0`` であり、指定された" "場合は ``1`` です。" #: ../../library/asyncio-eventloop.rst:515 msgid "" "*sock*, if given, should be an existing, already " "connected :class:`socket.socket` object to be used by the transport. If " "*sock* is given, none of *host*, *port*, *family*, *proto*, *flags*, " "*happy_eyeballs_delay*, *interleave* and *local_addr* should be specified." msgstr "" "*sock* を与える場合、トランスポートに使用される、既存の、かつ接続済" "の :class:`socket.socket` オブジェクトを指定します。*sock* を指定する場合、" "*host*、 *port*、 *family*、 *proto*、 *flags*、 *happy_eyeballs_delay*、 " "*interleave* および *local_addr* のいずれも指定してはいけません。" msgid "" "The *sock* argument transfers ownership of the socket to the transport " "created. To close the socket, call the " "transport's :meth:`~asyncio.BaseTransport.close` method." msgstr "" "*sock* 引数を渡すと、ソケットの所有権は作成されたトランスポートに移ります。\n" "ソケットを閉じるには、トランスポートの :meth:`~asyncio.BaseTransport.close` " "メソッドを呼び出してください。" #: ../../library/asyncio-eventloop.rst:527 msgid "" "*local_addr*, if given, is a ``(local_host, local_port)`` tuple used to bind " "the socket locally. The *local_host* and *local_port* are looked up using " "``getaddrinfo()``, similarly to *host* and *port*." msgstr "" "*local_addr* を与える場合、ソケットをローカルにバインドするために使用する " "``(local_host, local_port)`` タプルを指定します。 *local_host* と " "*local_port* は、 *host* および *port* と同じく ``getaddrinfo()`` を使って" "ルックアップされます。" #: ../../library/asyncio-eventloop.rst:531 #: ../../library/asyncio-eventloop.rst:983 msgid "" "*ssl_handshake_timeout* is (for a TLS connection) the time in seconds to " "wait for the TLS handshake to complete before aborting the connection. " "``60.0`` seconds if ``None`` (default)." msgstr "" "*ssl_handshake_timeout* は TLS ハンドシェイクが完了するまでの (TLS 接続のため" "の) 待ち時間を秒単位で指定します。指定した待ち時間を超えると接続は中断しま" "す。 ``None`` が与えられた場合はデフォルト値 ``60.0`` が使われます。" 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 "" "*ssl_shutdown_timeout* は、接続を中断する前に SSL の終了処理を待つ時間を秒単" "位で指定します。\n" "``None`` (デフォルト) の場合は ``30.0`` 秒です。" msgid "" "*all_errors* determines what exceptions are raised when a connection cannot " "be created. By default, only a single ``Exception`` is raised: the first " "exception if there is only one or all errors have same message, or a single " "``OSError`` with the error messages combined. When ``all_errors`` is " "``True``, an ``ExceptionGroup`` will be raised containing all exceptions " "(even if there is only one)." msgstr "" "*all_errors* は、接続を確立できなかった場合に送出する例外を指定します。\n" "デフォルトでは ``Exception`` を一つだけ送出します。\n" "例外が一つだけの場合や、すべてのエラーメッセージが同じ場合は最初の例外、それ" "以外の場合はエラーメッセージをまとめた一つの ``OSError`` です。\n" "``all_errors`` が ``True`` の場合、すべての例外を含む ``ExceptionGroup`` を送" "出します (例外が一つだけでも同じです)。" #: ../../library/asyncio-eventloop.rst:549 #: ../../library/asyncio-eventloop.rst:806 msgid "Added support for SSL/TLS in :class:`ProactorEventLoop`." msgstr "" ":class:`ProactorEventLoop` において SSL/TLS のサポートが追加されました。" #: ../../library/asyncio-eventloop.rst:553 msgid "" "The socket option :ref:`socket.TCP_NODELAY <socket-unix-constants>` is set " |
| You are visitor 01402520 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. |