asyncio-eventloop.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.10\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-06 00:23+0000\n"
"PO-Revision-Date: 2022-02-20 12:36+0800\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\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"
"X-Generator: Poedit 3.0.1\n"

#: ../../library/asyncio-eventloop.rst:8
msgid "Event Loop"
msgstr ""

#: ../../library/asyncio-eventloop.rst:10
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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../library/asyncio-eventloop.rst:36
msgid ""
"If there is no running event loop a :exc:`RuntimeError` is raised. This "
"function can only be called from a coroutine or a callback."
msgstr ""

#: ../../library/asyncio-eventloop.rst:43
msgid "Get the current event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:45
msgid ""
"If there is no current event loop set in the current OS thread, the OS "
"thread is main, and :func:`set_event_loop` has not yet been called, asyncio "
"will create a new event loop and set it as the current one."
msgstr ""

#: ../../library/asyncio-eventloop.rst:50
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 ""

#: ../../library/asyncio-eventloop.rst:55
msgid ""
"Consider also using the :func:`asyncio.run` function instead of using lower "
"level functions to manually create and close an event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:58
msgid ""
"Deprecation warning is emitted if there is no running event loop. In future "
"Python releases, this function will be an alias of :func:`get_running_loop`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:65
msgid "Set *loop* as a current event loop for the current OS thread."
msgstr ""

#: ../../library/asyncio-eventloop.rst:69
msgid "Create and return a new event loop object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:71
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 ""

#: ../../library/asyncio-eventloop.rst:77
msgid "Contents"
msgstr "目錄"

#: ../../library/asyncio-eventloop.rst:78
msgid "This documentation page contains the following sections:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:80
msgid ""
"The `Event Loop Methods`_ section is the reference documentation of the "
"event loop APIs;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:83
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 ""

#: ../../library/asyncio-eventloop.rst:87
msgid ""
"The `Server Objects`_ section documents types returned from event loop "
"methods like :meth:`loop.create_server`;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:90
msgid ""
"The `Event Loop Implementations`_ section documents the :class:"
"`SelectorEventLoop` and :class:`ProactorEventLoop` classes;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:93
msgid ""
"The `Examples`_ section showcases how to work with some event loop APIs."
msgstr ""

#: ../../library/asyncio-eventloop.rst:100
msgid "Event Loop Methods"
msgstr ""

#: ../../library/asyncio-eventloop.rst:102
msgid "Event loops have **low-level** APIs for the following:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:110
msgid "Running and stopping the loop"
msgstr ""

#: ../../library/asyncio-eventloop.rst:114
msgid "Run until the *future* (an instance of :class:`Future`) has completed."
msgstr ""

#: ../../library/asyncio-eventloop.rst:117
msgid ""
"If the argument is a :ref:`coroutine object <coroutine>` it is implicitly "
"scheduled to run as a :class:`asyncio.Task`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:120
msgid "Return the Future's result or raise its exception."
msgstr ""

#: ../../library/asyncio-eventloop.rst:124
msgid "Run the event loop until :meth:`stop` is called."
msgstr ""

#: ../../library/asyncio-eventloop.rst:126
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 ""

#: ../../library/asyncio-eventloop.rst:131
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 ""

#: ../../library/asyncio-eventloop.rst:139
msgid "Stop the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:143
msgid "Return ``True`` if the event loop is currently running."
msgstr ""

#: ../../library/asyncio-eventloop.rst:147
msgid "Return ``True`` if the event loop was closed."
msgstr ""

#: ../../library/asyncio-eventloop.rst:151
msgid "Close the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:153
msgid ""
"The loop must not be running when this function is called. Any pending "
"callbacks will be discarded."
msgstr ""

#: ../../library/asyncio-eventloop.rst:156
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:159
msgid ""
"This method is idempotent and irreversible.  No other methods should be "
"called after the event loop is closed."
msgstr ""

#: ../../library/asyncio-eventloop.rst:164
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 ""

#: ../../library/asyncio-eventloop.rst:170
#: ../../library/asyncio-eventloop.rst:190
msgid ""
"Note that there is no need to call this function when :func:`asyncio.run` is "
"used."
msgstr ""

#: ../../library/asyncio-eventloop.rst:173
#: ../../library/asyncio-eventloop.rst:1104
#: ../../library/asyncio-eventloop.rst:1490
msgid "Example::"
msgstr ""
"範例：\n"
"\n"
"::"

#: ../../library/asyncio-eventloop.rst:185
msgid ""
"Schedule the closure of the default executor and wait for it to join all of "
"the threads in the :class:`ThreadPoolExecutor`. After calling this method, "
"a :exc:`RuntimeError` will be raised if :meth:`loop.run_in_executor` is "
"called while using the default executor."
msgstr ""

#: ../../library/asyncio-eventloop.rst:197
msgid "Scheduling callbacks"
msgstr ""

#: ../../library/asyncio-eventloop.rst:201
msgid ""
"Schedule the *callback* :term:`callback` to be called with *args* arguments "
"at the next iteration of the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:204
msgid ""
"Callbacks are called in the order in which they are registered. Each "
"callback will be called exactly once."
msgstr ""

#: ../../library/asyncio-eventloop.rst:207
#: ../../library/asyncio-eventloop.rst:274
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 ""

#: ../../library/asyncio-eventloop.rst:211
msgid ""
"An instance of :class:`asyncio.Handle` is returned, which can be used later "
"to cancel the callback."
msgstr ""

#: ../../library/asyncio-eventloop.rst:214
msgid "This method is not thread-safe."
msgstr ""

#: ../../library/asyncio-eventloop.rst:218
msgid ""
"A thread-safe variant of :meth:`call_soon`.  Must be used to schedule "
"callbacks *from another thread*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:221
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 ""

#: ../../library/asyncio-eventloop.rst:225
msgid ""
"See the :ref:`concurrency and multithreading <asyncio-multithreading>` "
"section of the documentation."
msgstr ""

#: ../../library/asyncio-eventloop.rst:228
#: ../../library/asyncio-eventloop.rst:278
#: ../../library/asyncio-eventloop.rst:298
msgid ""
"The *context* keyword-only parameter was added. See :pep:`567` for more "
"details."
msgstr ""

#: ../../library/asyncio-eventloop.rst:236
msgid ""
"Most :mod:`asyncio` scheduling functions don't allow passing keyword "
"arguments.  To do that, use :func:`functools.partial`::"
msgstr ""

#: ../../library/asyncio-eventloop.rst:243
msgid ""
"Using partial objects is usually more convenient than using lambdas, as "
"asyncio can render partial objects better in debug and error messages."
msgstr ""

#: ../../library/asyncio-eventloop.rst:251
msgid "Scheduling delayed callbacks"
msgstr ""

#: ../../library/asyncio-eventloop.rst:253
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 ""

#: ../../library/asyncio-eventloop.rst:260
msgid ""
"Schedule *callback* to be called after the given *delay* number of seconds "
"(can be either an int or a float)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:263
#: ../../library/asyncio-eventloop.rst:295
msgid ""
"An instance of :class:`asyncio.TimerHandle` is returned which can be used to "
"cancel the callback."
msgstr ""

#: ../../library/asyncio-eventloop.rst:266
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 ""

#: ../../library/asyncio-eventloop.rst:270
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 ""

#: ../../library/asyncio-eventloop.rst:282
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 ""

#: ../../library/asyncio-eventloop.rst:289
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 ""

#: ../../library/asyncio-eventloop.rst:293
msgid "This method's behavior is the same as :meth:`call_later`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:302
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 ""

#: ../../library/asyncio-eventloop.rst:309
msgid ""
"Return the current time, as a :class:`float` value, according to the event "
"loop's internal monotonic clock."
msgstr ""

#: ../../library/asyncio-eventloop.rst:313
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 ""

#: ../../library/asyncio-eventloop.rst:319
msgid "The :func:`asyncio.sleep` function."
msgstr ""

#: ../../library/asyncio-eventloop.rst:323
msgid "Creating Futures and Tasks"
msgstr ""

#: ../../library/asyncio-eventloop.rst:327
msgid "Create an :class:`asyncio.Future` object attached to the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:329
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 ""

#: ../../library/asyncio-eventloop.rst:337
msgid ""
"Schedule the execution of :ref:`coroutine <coroutine>` *coro*. Return a :"
"class:`Task` object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:340
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 ""

#: ../../library/asyncio-eventloop.rst:344
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 ""

#: ../../library/asyncio-eventloop.rst:347
msgid "Added the *name* parameter."
msgstr "加入 *name* 參數。"

#: ../../library/asyncio-eventloop.rst:352
msgid "Set a task factory that will be used by :meth:`loop.create_task`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:355
msgid ""
"If *factory* is ``None`` the default task factory will be set. Otherwise, "
"*factory* must be a *callable* with the signature matching ``(loop, coro)``, "
"where *loop* is a reference to the active event loop, and *coro* is a "
"coroutine object.  The callable must return a :class:`asyncio.Future`-"
"compatible object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:363
msgid "Return a task factory or ``None`` if the default one is in use."
msgstr ""

#: ../../library/asyncio-eventloop.rst:367
msgid "Opening network connections"
msgstr ""

#: ../../library/asyncio-eventloop.rst:376
msgid ""
"Open a streaming transport connection to a given address specified by *host* "
"and *port*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:379
msgid ""
"The socket family can be either :py:data:`~socket.AF_INET` or :py:data:"
"`~socket.AF_INET6` depending on *host* (or the *family* argument, if "
"provided)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:383
msgid "The socket type will be :py:data:`~socket.SOCK_STREAM`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:385
#: ../../library/asyncio-eventloop.rst:1020
#: ../../library/asyncio-eventloop.rst:1036
msgid ""
"*protocol_factory* must be a callable returning an :ref:`asyncio protocol "
"<asyncio-protocol>` implementation."
msgstr ""

#: ../../library/asyncio-eventloop.rst:388
msgid ""
"This method will try to establish the connection in the background. When "
"successful, it returns a ``(transport, protocol)`` pair."
msgstr ""

#: ../../library/asyncio-eventloop.rst:391
msgid "The chronological synopsis of the underlying operation is as follows:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:393
msgid ""
"The connection is established and a :ref:`transport <asyncio-transport>` is "
"created for it."
msgstr ""

#: ../../library/asyncio-eventloop.rst:396
msgid ""
"*protocol_factory* is called without arguments and is expected to return a :"
"ref:`protocol <asyncio-protocol>` instance."
msgstr ""

#: ../../library/asyncio-eventloop.rst:399
msgid ""
"The protocol instance is coupled with the transport by calling its :meth:"
"`~BaseProtocol.connection_made` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:402
msgid "A ``(transport, protocol)`` tuple is returned on success."
msgstr ""

#: ../../library/asyncio-eventloop.rst:404
msgid ""
"The created transport is an implementation-dependent bidirectional stream."
msgstr ""

#: ../../library/asyncio-eventloop.rst:407
#: ../../library/asyncio-eventloop.rst:535
msgid "Other arguments:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:409
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 ""

#: ../../library/asyncio-eventloop.rst:415
msgid ":ref:`SSL/TLS security considerations <ssl-security>`"
msgstr ""

#: ../../library/asyncio-eventloop.rst:417
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 ""

#: ../../library/asyncio-eventloop.rst:425
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 ""

#: ../../library/asyncio-eventloop.rst:430
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 ""

#: ../../library/asyncio-eventloop.rst:438
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 ""

#: ../../library/asyncio-eventloop.rst:447
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 ""

#: ../../library/asyncio-eventloop.rst:455
#: ../../library/asyncio-eventloop.rst:566
#: ../../library/asyncio-eventloop.rst:752
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 ""

#: ../../library/asyncio-eventloop.rst:459
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 ""

#: ../../library/asyncio-eventloop.rst:463
#: ../../library/asyncio-eventloop.rst:829
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 ""

#: ../../library/asyncio-eventloop.rst:469
#: ../../library/asyncio-eventloop.rst:693
msgid "Added support for SSL/TLS in :class:`ProactorEventLoop`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:473
msgid ""
"The socket option :py:data:`~socket.TCP_NODELAY` is set by default for all "
"TCP connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:478
#: ../../library/asyncio-eventloop.rst:769
msgid "Added the *ssl_handshake_timeout* parameter."
msgstr "增加 *ssl_handshake_timeout* 參數。"

#: ../../library/asyncio-eventloop.rst:482
msgid "Added the *happy_eyeballs_delay* and *interleave* parameters."
msgstr "加入 *happy_eyeballs_delay* 和 *interleave* 參數。"

#: ../../library/asyncio-eventloop.rst:484
msgid ""
"Happy Eyeballs Algorithm: Success with Dual-Stack Hosts. When a server's "
"IPv4 path and protocol are working, but the server's IPv6 path and protocol "
"are not working, a dual-stack client application experiences significant "
"connection delay compared to an IPv4-only client.  This is undesirable "
"because it causes the dual- stack client to have a worse user experience.  "
"This document specifies requirements for algorithms that reduce this user-"
"visible delay and provides an algorithm."
msgstr ""

#: ../../library/asyncio-eventloop.rst:493
msgid "For more information: https://tools.ietf.org/html/rfc6555"
msgstr "更多資訊請見：\\ https://tools.ietf.org/html/rfc6555"

#: ../../library/asyncio-eventloop.rst:497
msgid ""
"The :func:`open_connection` function is a high-level alternative API.  It "
"returns a pair of (:class:`StreamReader`, :class:`StreamWriter`) that can be "
"used directly in async/await code."
msgstr ""

#: ../../library/asyncio-eventloop.rst:508
msgid ""
"The parameter *reuse_address* is no longer supported, as using :py:data:"
"`~sockets.SO_REUSEADDR` poses a significant security concern for UDP. "
"Explicitly passing ``reuse_address=True`` will raise an exception."
msgstr ""

#: ../../library/asyncio-eventloop.rst:512
msgid ""
"When multiple processes with differing UIDs assign sockets to an identical "
"UDP socket address with ``SO_REUSEADDR``, incoming packets can become "
"randomly distributed among the sockets."
msgstr ""

#: ../../library/asyncio-eventloop.rst:516
msgid ""
"For supported platforms, *reuse_port* can be used as a replacement for "
"similar functionality. With *reuse_port*, :py:data:`~sockets.SO_REUSEPORT` "
"is used instead, which specifically prevents processes with differing UIDs "
"from assigning sockets to the same socket address."
msgstr ""

#: ../../library/asyncio-eventloop.rst:522
msgid "Create a datagram connection."
msgstr ""

#: ../../library/asyncio-eventloop.rst:524
msgid ""
"The socket family can be either :py:data:`~socket.AF_INET`, :py:data:"
"`~socket.AF_INET6`, or :py:data:`~socket.AF_UNIX`, depending on *host* (or "
"the *family* argument, if provided)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:528
msgid "The socket type will be :py:data:`~socket.SOCK_DGRAM`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:530
#: ../../library/asyncio-eventloop.rst:628
#: ../../library/asyncio-eventloop.rst:744
msgid ""
"*protocol_factory* must be a callable returning a :ref:`protocol <asyncio-"
"protocol>` implementation."
msgstr ""

#: ../../library/asyncio-eventloop.rst:533
#: ../../library/asyncio-eventloop.rst:593
msgid "A tuple of ``(transport, protocol)`` is returned on success."
msgstr ""

#: ../../library/asyncio-eventloop.rst:537
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 :"
"meth:`getaddrinfo`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:541
msgid ""
"*remote_addr*, if given, is a ``(remote_host, remote_port)`` tuple used to "
"connect the socket to a remote address.  The *remote_host* and *remote_port* "
"are looked up using :meth:`getaddrinfo`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:545
msgid ""
"*family*, *proto*, *flags* are the optional address family, protocol and "
"flags to be passed through to :meth:`getaddrinfo` for *host* resolution. If "
"given, these should all be integers from the corresponding :mod:`socket` "
"module constants."
msgstr ""

#: ../../library/asyncio-eventloop.rst:550
msgid ""
"*reuse_port* tells the kernel to allow this endpoint to be bound to the same "
"port as other existing endpoints are bound to, so long as they all set this "
"flag when being created. This option is not supported on Windows and some "
"Unixes. If the :py:data:`~socket.SO_REUSEPORT` constant is not defined then "
"this capability is unsupported."
msgstr ""

#: ../../library/asyncio-eventloop.rst:556
msgid ""
"*allow_broadcast* tells the kernel to allow this endpoint to send messages "
"to the broadcast address."
msgstr ""

#: ../../library/asyncio-eventloop.rst:559
msgid ""
"*sock* can optionally be specified in order to use a preexisting, already "
"connected, :class:`socket.socket` object to be used by the transport. If "
"specified, *local_addr* and *remote_addr* should be omitted (must be :const:"
"`None`)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:570
msgid ""
"See :ref:`UDP echo client protocol <asyncio-udp-echo-client-protocol>` and :"
"ref:`UDP echo server protocol <asyncio-udp-echo-server-protocol>` examples."
msgstr ""

#: ../../library/asyncio-eventloop.rst:573
msgid ""
"The *family*, *proto*, *flags*, *reuse_address*, *reuse_port, "
"*allow_broadcast*, and *sock* parameters were added."
msgstr ""

#: ../../library/asyncio-eventloop.rst:577
msgid ""
"The *reuse_address* parameter is no longer supported due to security "
"concerns."
msgstr ""

#: ../../library/asyncio-eventloop.rst:581
msgid "Added support for Windows."
msgstr "新增對於 Windows 的支援。"

#: ../../library/asyncio-eventloop.rst:588
msgid "Create a Unix connection."
msgstr ""

#: ../../library/asyncio-eventloop.rst:590
msgid ""
"The socket family will be :py:data:`~socket.AF_UNIX`; socket type will be :"
"py:data:`~socket.SOCK_STREAM`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:595
msgid ""
"*path* is the name of a Unix domain socket and is required, unless a *sock* "
"parameter is specified.  Abstract Unix sockets, :class:`str`, :class:"
"`bytes`, and :class:`~pathlib.Path` paths are supported."
msgstr ""

#: ../../library/asyncio-eventloop.rst:600
msgid ""
"See the documentation of the :meth:`loop.create_connection` method for "
"information about arguments to this method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:604
#: ../../library/asyncio-eventloop.rst:728
#: ../../library/asyncio-eventloop.rst:1087
msgid ":ref:`Availability <availability>`: Unix."
msgstr ":ref:`適用 <availability>`：Unix。"

#: ../../library/asyncio-eventloop.rst:605
msgid ""
"Added the *ssl_handshake_timeout* parameter. The *path* parameter can now be "
"a :term:`path-like object`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:611
msgid "Creating network servers"
msgstr ""

#: ../../library/asyncio-eventloop.rst:621
msgid ""
"Create a TCP server (socket type :data:`~socket.SOCK_STREAM`) listening on "
"*port* of the *host* address."
msgstr ""

#: ../../library/asyncio-eventloop.rst:624
msgid "Returns a :class:`Server` object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:626
msgid "Arguments:"
msgstr "引數："

#: ../../library/asyncio-eventloop.rst:631
msgid ""
"The *host* parameter can be set to several types which determine where the "
"server would be listening:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:634
msgid ""
"If *host* is a string, the TCP server is bound to a single network interface "
"specified by *host*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:637
msgid ""
"If *host* is a sequence of strings, the TCP server is bound to all network "
"interfaces specified by the sequence."
msgstr ""

#: ../../library/asyncio-eventloop.rst:640
msgid ""
"If *host* is an empty string or ``None``, all interfaces are assumed and a "
"list of multiple sockets will be returned (most likely one for IPv4 and "
"another one for IPv6)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:644
msgid ""
"The *port* parameter can be set to specify which port the server should "
"listen on. If ``0`` or ``None`` (the default), a random unused port will be "
"selected (note that if *host* resolves to multiple network interfaces, a "
"different random port will be selected for each interface)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:649
msgid ""
"*family* can be set to either :data:`socket.AF_INET` or :data:`~socket."
"AF_INET6` to force the socket to use IPv4 or IPv6. If not set, the *family* "
"will be determined from host name (defaults to :data:`~socket.AF_UNSPEC`)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:654
msgid "*flags* is a bitmask for :meth:`getaddrinfo`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:656
msgid ""
"*sock* can optionally be specified in order to use a preexisting socket "
"object. If specified, *host* and *port* must not be specified."
msgstr ""

#: ../../library/asyncio-eventloop.rst:661
msgid ""
"The *sock* argument transfers ownership of the socket to the server created. "
"To close the socket, call the server's :meth:`~asyncio.Server.close` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:665
msgid ""
"*backlog* is the maximum number of queued connections passed to :meth:"
"`~socket.socket.listen` (defaults to 100)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:668
msgid ""
"*ssl* can be set to an :class:`~ssl.SSLContext` instance to enable TLS over "
"the accepted connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:671
msgid ""
"*reuse_address* tells the kernel to reuse a local socket in ``TIME_WAIT`` "
"state, without waiting for its natural timeout to expire. If not specified "
"will automatically be set to ``True`` on Unix."
msgstr ""

#: ../../library/asyncio-eventloop.rst:676
msgid ""
"*reuse_port* tells the kernel to allow this endpoint to be bound to the same "
"port as other existing endpoints are bound to, so long as they all set this "
"flag when being created. This option is not supported on Windows."
msgstr ""

#: ../../library/asyncio-eventloop.rst:681
msgid ""
"*ssl_handshake_timeout* is (for a TLS server) the time in seconds to wait "
"for the TLS handshake to complete before aborting the connection. ``60.0`` "
"seconds if ``None`` (default)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:685
msgid ""
"*start_serving* set to ``True`` (the default) causes the created server to "
"start accepting connections immediately.  When set to ``False``, the user "
"should await on :meth:`Server.start_serving` or :meth:`Server.serve_forever` "
"to make the server to start accepting connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:697
msgid "The *host* parameter can be a sequence of strings."
msgstr ""

#: ../../library/asyncio-eventloop.rst:701
msgid ""
"Added *ssl_handshake_timeout* and *start_serving* parameters. The socket "
"option :py:data:`~socket.TCP_NODELAY` is set by default for all TCP "
"connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:707
msgid ""
"The :func:`start_server` function is a higher-level alternative API that "
"returns a pair of :class:`StreamReader` and :class:`StreamWriter` that can "
"be used in an async/await code."
msgstr ""

#: ../../library/asyncio-eventloop.rst:716
msgid ""
"Similar to :meth:`loop.create_server` but works with the :py:data:`~socket."
"AF_UNIX` socket family."
msgstr ""

#: ../../library/asyncio-eventloop.rst:719
msgid ""
"*path* is the name of a Unix domain socket, and is required, unless a *sock* "
"argument is provided.  Abstract Unix sockets, :class:`str`, :class:`bytes`, "
"and :class:`~pathlib.Path` paths are supported."
msgstr ""

#: ../../library/asyncio-eventloop.rst:724
msgid ""
"See the documentation of the :meth:`loop.create_server` method for "
"information about arguments to this method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:731
msgid ""
"Added the *ssl_handshake_timeout* and *start_serving* parameters. The *path* "
"parameter can now be a :class:`~pathlib.Path` object."
msgstr ""
"新增 *ssl_handshake_timeout* 與 *start_serving* 參數。\\ *path* 參數現在可為"
"一個 :class:`~pathlib.Path` 物件。"

#: ../../library/asyncio-eventloop.rst:737
msgid "Wrap an already accepted connection into a transport/protocol pair."
msgstr ""

#: ../../library/asyncio-eventloop.rst:739
msgid ""
"This method can be used by servers that accept connections outside of "
"asyncio but that use asyncio to handle them."
msgstr ""

#: ../../library/asyncio-eventloop.rst:742
#: ../../library/asyncio-eventloop.rst:815
msgid "Parameters:"
msgstr "參數："

#: ../../library/asyncio-eventloop.rst:747
msgid ""
"*sock* is a preexisting socket object returned from :meth:`socket.accept "
"<socket.socket.accept>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:756
msgid ""
"*ssl* can be set to an :class:`~ssl.SSLContext` to enable SSL over the "
"accepted connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:759
msgid ""
"*ssl_handshake_timeout* is (for an SSL connection) the time in seconds to "
"wait for the SSL handshake to complete before aborting the connection. "
"``60.0`` seconds if ``None`` (default)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:763
msgid "Returns a ``(transport, protocol)`` pair."
msgstr ""

#: ../../library/asyncio-eventloop.rst:773
msgid "Transferring files"
msgstr ""

#: ../../library/asyncio-eventloop.rst:778
msgid ""
"Send a *file* over a *transport*.  Return the total number of bytes sent."
msgstr ""

#: ../../library/asyncio-eventloop.rst:781
msgid "The method uses high-performance :meth:`os.sendfile` if available."
msgstr ""

#: ../../library/asyncio-eventloop.rst:783
msgid "*file* must be a regular file object opened in binary mode."
msgstr ""

#: ../../library/asyncio-eventloop.rst:785
#: ../../library/asyncio-eventloop.rst:975
msgid ""
"*offset* tells from where to start reading the file. If specified, *count* "
"is the total number of bytes to transmit as opposed to sending the file "
"until EOF is reached. File position is always updated, even when this method "
"raises an error, and :meth:`file.tell() <io.IOBase.tell>` can be used to "
"obtain the actual number of bytes sent."
msgstr ""

#: ../../library/asyncio-eventloop.rst:792
msgid ""
"*fallback* set to ``True`` makes asyncio to manually read and send the file "
"when the platform does not support the sendfile system call (e.g. Windows or "
"SSL socket on Unix)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:796
msgid ""
"Raise :exc:`SendfileNotAvailableError` if the system does not support the "
"*sendfile* syscall and *fallback* is ``False``."
msgstr ""

#: ../../library/asyncio-eventloop.rst:803
msgid "TLS Upgrade"
msgstr ""

#: ../../library/asyncio-eventloop.rst:809
msgid "Upgrade an existing transport-based connection to TLS."
msgstr ""

#: ../../library/asyncio-eventloop.rst:811
msgid ""
"Return a new transport instance, that the *protocol* must start using "
"immediately after the *await*.  The *transport* instance passed to the "
"*start_tls* method should never be used again."
msgstr ""

#: ../../library/asyncio-eventloop.rst:817
msgid ""
"*transport* and *protocol* instances that methods like :meth:`~loop."
"create_server` and :meth:`~loop.create_connection` return."
msgstr ""

#: ../../library/asyncio-eventloop.rst:821
msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:823
msgid ""
"*server_side* pass ``True`` when a server-side connection is being upgraded "
"(like the one created by :meth:`~loop.create_server`)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:826
msgid ""
"*server_hostname*: sets or overrides the host name that the target server's "
"certificate will be matched against."
msgstr ""

#: ../../library/asyncio-eventloop.rst:837
msgid "Watching file descriptors"
msgstr ""

#: ../../library/asyncio-eventloop.rst:841
msgid ""
"Start monitoring the *fd* file descriptor for read availability and invoke "
"*callback* with the specified arguments once *fd* is available for reading."
msgstr ""

#: ../../library/asyncio-eventloop.rst:847
msgid "Stop monitoring the *fd* file descriptor for read availability."
msgstr ""

#: ../../library/asyncio-eventloop.rst:851
msgid ""
"Start monitoring the *fd* file descriptor for write availability and invoke "
"*callback* with the specified arguments once *fd* is available for writing."
msgstr ""

#: ../../library/asyncio-eventloop.rst:855
#: ../../library/asyncio-eventloop.rst:1074
msgid ""
"Use :func:`functools.partial` :ref:`to pass keyword arguments <asyncio-pass-"
"keywords>` to *callback*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:860
msgid "Stop monitoring the *fd* file descriptor for write availability."
msgstr ""

#: ../../library/asyncio-eventloop.rst:862
msgid ""
"See also :ref:`Platform Support <asyncio-platform-support>` section for some "
"limitations of these methods."
msgstr ""

#: ../../library/asyncio-eventloop.rst:867
msgid "Working with socket objects directly"
msgstr ""

#: ../../library/asyncio-eventloop.rst:869
msgid ""
"In general, protocol implementations that use transport-based APIs such as :"
"meth:`loop.create_connection` and :meth:`loop.create_server` are faster than "
"implementations that work with sockets directly. However, there are some use "
"cases when performance is not critical, and working with :class:`~socket."
"socket` objects directly is more convenient."
msgstr ""

#: ../../library/asyncio-eventloop.rst:878
msgid ""
"Receive up to *nbytes* from *sock*.  Asynchronous version of :meth:`socket."
"recv() <socket.socket.recv>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:881
msgid "Return the received data as a bytes object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:883
#: ../../library/asyncio-eventloop.rst:897
#: ../../library/asyncio-eventloop.rst:912
#: ../../library/asyncio-eventloop.rst:925
#: ../../library/asyncio-eventloop.rst:951
#: ../../library/asyncio-eventloop.rst:989
msgid "*sock* must be a non-blocking socket."
msgstr ""

#: ../../library/asyncio-eventloop.rst:885
msgid ""
"Even though this method was always documented as a coroutine method, "
"releases before Python 3.7 returned a :class:`Future`. Since Python 3.7 this "
"is an ``async def`` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:892
msgid ""
"Receive data from *sock* into the *buf* buffer.  Modeled after the blocking :"
"meth:`socket.recv_into() <socket.socket.recv_into>` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:895
msgid "Return the number of bytes written to the buffer."
msgstr ""

#: ../../library/asyncio-eventloop.rst:903
msgid ""
"Send *data* to the *sock* socket. Asynchronous version of :meth:`socket."
"sendall() <socket.socket.sendall>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:906
msgid ""
"This method continues to send to the socket until either all data in *data* "
"has been sent or an error occurs.  ``None`` is returned on success.  On "
"error, an exception is raised. Additionally, there is no way to determine "
"how much data, if any, was successfully processed by the receiving end of "
"the connection."
msgstr ""

#: ../../library/asyncio-eventloop.rst:914
msgid ""
"Even though the method was always documented as a coroutine method, before "
"Python 3.7 it returned an :class:`Future`. Since Python 3.7, this is an "
"``async def`` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:921
msgid "Connect *sock* to a remote socket at *address*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:923
msgid ""
"Asynchronous version of :meth:`socket.connect() <socket.socket.connect>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:927
msgid ""
"``address`` no longer needs to be resolved.  ``sock_connect`` will try to "
"check if the *address* is already resolved by calling :func:`socket."
"inet_pton`.  If not, :meth:`loop.getaddrinfo` will be used to resolve the "
"*address*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:936
msgid ""
":meth:`loop.create_connection` and  :func:`asyncio.open_connection() "
"<open_connection>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:942
msgid ""
"Accept a connection.  Modeled after the blocking :meth:`socket.accept() "
"<socket.socket.accept>` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:945
msgid ""
"The socket must be bound to an address and listening for connections. The "
"return value is a pair ``(conn, address)`` where *conn* is a *new* socket "
"object usable to send and receive data on the connection, and *address* is "
"the address bound to the socket on the other end of the connection."
msgstr ""

#: ../../library/asyncio-eventloop.rst:953
msgid ""
"Even though the method was always documented as a coroutine method, before "
"Python 3.7 it returned a :class:`Future`. Since Python 3.7, this is an "
"``async def`` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:960
msgid ":meth:`loop.create_server` and :func:`start_server`."
msgstr ":meth:`loop.create_server` 和 :func:`start_server`\\ 。"

#: ../../library/asyncio-eventloop.rst:965
msgid ""
"Send a file using high-performance :mod:`os.sendfile` if possible. Return "
"the total number of bytes sent."
msgstr ""

#: ../../library/asyncio-eventloop.rst:968
msgid ""
"Asynchronous version of :meth:`socket.sendfile() <socket.socket.sendfile>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:970
msgid ""
"*sock* must be a non-blocking :const:`socket.SOCK_STREAM` :class:`~socket."
"socket`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:973
msgid "*file* must be a regular file object open in binary mode."
msgstr ""

#: ../../library/asyncio-eventloop.rst:982
msgid ""
"*fallback*, when set to ``True``, makes asyncio manually read and send the "
"file when the platform does not support the sendfile syscall (e.g. Windows "
"or SSL socket on Unix)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:986
msgid ""
"Raise :exc:`SendfileNotAvailableError` if the system does not support "
"*sendfile* syscall and *fallback* is ``False``."
msgstr ""

#: ../../library/asyncio-eventloop.rst:995
msgid "DNS"
msgstr "DNS"

#: ../../library/asyncio-eventloop.rst:1000
msgid "Asynchronous version of :meth:`socket.getaddrinfo`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1004
msgid "Asynchronous version of :meth:`socket.getnameinfo`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1006
msgid ""
"Both *getaddrinfo* and *getnameinfo* methods were always documented to "
"return a coroutine, but prior to Python 3.7 they were, in fact, returning :"
"class:`asyncio.Future` objects.  Starting with Python 3.7 both methods are "
"coroutines."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1014
msgid "Working with pipes"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1018
msgid "Register the read end of *pipe* in the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1023
msgid "*pipe* is a :term:`file-like object <file object>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1025
msgid ""
"Return pair ``(transport, protocol)``, where *transport* supports the :class:"
"`ReadTransport` interface and *protocol* is an object instantiated by the "
"*protocol_factory*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1029
#: ../../library/asyncio-eventloop.rst:1045
msgid ""
"With :class:`SelectorEventLoop` event loop, the *pipe* is set to non-"
"blocking mode."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1034
msgid "Register the write end of *pipe* in the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1039
msgid "*pipe* is :term:`file-like object <file object>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1041
msgid ""
"Return pair ``(transport, protocol)``, where *transport* supports :class:"
"`WriteTransport` interface and *protocol* is an object instantiated by the "
"*protocol_factory*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1050
msgid ""
":class:`SelectorEventLoop` does not support the above methods on Windows.  "
"Use :class:`ProactorEventLoop` instead for Windows."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1055
msgid ""
"The :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell` methods."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1060
msgid "Unix signals"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1064
msgid "Set *callback* as the handler for the *signum* signal."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1066
msgid ""
"The callback will be invoked by *loop*, along with other queued callbacks "
"and runnable coroutines of that event loop. Unlike signal handlers "
"registered using :func:`signal.signal`, a callback registered with this "
"function is allowed to interact with the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1071
msgid ""
"Raise :exc:`ValueError` if the signal number is invalid or uncatchable. "
"Raise :exc:`RuntimeError` if there is a problem setting up the handler."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1077
msgid ""
"Like :func:`signal.signal`, this function must be invoked in the main thread."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1082
msgid "Remove the handler for the *sig* signal."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1084
msgid ""
"Return ``True`` if the signal handler was removed, or ``False`` if no "
"handler was set for the given signal."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1091
msgid "The :mod:`signal` module."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1095
msgid "Executing code in thread or process pools"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1099
msgid "Arrange for *func* to be called in the specified executor."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1101
msgid ""
"The *executor* argument should be an :class:`concurrent.futures.Executor` "
"instance. The default executor is used if *executor* is ``None``."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1145
msgid "This method returns a :class:`asyncio.Future` object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1147
msgid ""
"Use :func:`functools.partial` :ref:`to pass keyword arguments <asyncio-pass-"
"keywords>` to *func*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1150
msgid ""
":meth:`loop.run_in_executor` no longer configures the ``max_workers`` of the "
"thread pool executor it creates, instead leaving it up to the thread pool "
"executor (:class:`~concurrent.futures.ThreadPoolExecutor`) to set the "
"default."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1159
msgid ""
"Set *executor* as the default executor used by :meth:`run_in_executor`. "
"*executor* should be an instance of :class:`~concurrent.futures."
"ThreadPoolExecutor`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1163
msgid ""
"Using an executor that is not an instance of :class:`~concurrent.futures."
"ThreadPoolExecutor` is deprecated and will trigger an error in Python 3.9."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1168
msgid ""
"*executor* must be an instance of :class:`concurrent.futures."
"ThreadPoolExecutor`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1173
msgid "Error Handling API"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1175
msgid "Allows customizing how exceptions are handled in the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1179
msgid "Set *handler* as the new event loop exception handler."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1181
msgid ""
"If *handler* is ``None``, the default exception handler will be set.  "
"Otherwise, *handler* must be a callable with the signature matching ``(loop, "
"context)``, where ``loop`` is a reference to the active event loop, and "
"``context`` is a ``dict`` object containing the details of the exception "
"(see :meth:`call_exception_handler` documentation for details about context)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1191
msgid ""
"Return the current exception handler, or ``None`` if no custom exception "
"handler was set."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1198
msgid "Default exception handler."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1200
msgid ""
"This is called when an exception occurs and no exception handler is set. "
"This can be called by a custom exception handler that wants to defer to the "
"default handler behavior."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1204
msgid ""
"*context* parameter has the same meaning as in :meth:"
"`call_exception_handler`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1209
msgid "Call the current event loop exception handler."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1211
msgid ""
"*context* is a ``dict`` object containing the following keys (new keys may "
"be introduced in future Python versions):"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1214
msgid "'message': Error message;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1215
msgid "'exception' (optional): Exception object;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1216
msgid "'future' (optional): :class:`asyncio.Future` instance;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1217
msgid "'task' (optional): :class:`asyncio.Task` instance;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1218
msgid "'handle' (optional): :class:`asyncio.Handle` instance;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1219
msgid "'protocol' (optional): :ref:`Protocol <asyncio-protocol>` instance;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1220
msgid "'transport' (optional): :ref:`Transport <asyncio-transport>` instance;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1221
msgid "'socket' (optional): :class:`socket.socket` instance;"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1223
msgid "'asyncgen' (optional): Asynchronous generator that caused"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1223
msgid "the exception."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1227
msgid ""
"This method should not be overloaded in subclassed event loops.  For custom "
"exception handling, use the :meth:`set_exception_handler()` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1232
msgid "Enabling debug mode"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1236
msgid "Get the debug mode (:class:`bool`) of the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1238
msgid ""
"The default value is ``True`` if the environment variable :envvar:"
"`PYTHONASYNCIODEBUG` is set to a non-empty string, ``False`` otherwise."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1244
msgid "Set the debug mode of the event loop."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1248
msgid ""
"The new :ref:`Python Development Mode <devmode>` can now also be used to "
"enable the debug mode."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1253
msgid "The :ref:`debug mode of asyncio <asyncio-debug-mode>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1257
msgid "Running Subprocesses"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1259
msgid ""
"Methods described in this subsections are low-level.  In regular async/await "
"code consider using the high-level :func:`asyncio.create_subprocess_shell` "
"and :func:`asyncio.create_subprocess_exec` convenience functions instead."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1266
msgid ""
"On Windows, the default event loop :class:`ProactorEventLoop` supports "
"subprocesses, whereas :class:`SelectorEventLoop` does not. See :ref:"
"`Subprocess Support on Windows <asyncio-windows-subprocess>` for details."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1275
msgid ""
"Create a subprocess from one or more string arguments specified by *args*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1278
msgid "*args* must be a list of strings represented by:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1280
msgid ":class:`str`;"
msgstr ":class:`str`\\ ；"

#: ../../library/asyncio-eventloop.rst:1281
msgid ""
"or :class:`bytes`, encoded to the :ref:`filesystem encoding <filesystem-"
"encoding>`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1284
msgid ""
"The first string specifies the program executable, and the remaining strings "
"specify the arguments.  Together, string arguments form the ``argv`` of the "
"program."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1288
msgid ""
"This is similar to the standard library :class:`subprocess.Popen` class "
"called with ``shell=False`` and the list of strings passed as the first "
"argument; however, where :class:`~subprocess.Popen` takes a single argument "
"which is list of strings, *subprocess_exec* takes multiple string arguments."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1294
msgid ""
"The *protocol_factory* must be a callable returning a subclass of the :class:"
"`asyncio.SubprocessProtocol` class."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1297
msgid "Other parameters:"
msgstr "其他參數："

#: ../../library/asyncio-eventloop.rst:1299
msgid "*stdin* can be any of these:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1301
msgid ""
"a file-like object representing a pipe to be connected to the subprocess's "
"standard input stream using :meth:`~loop.connect_write_pipe`"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1304
#: ../../library/asyncio-eventloop.rst:1316
#: ../../library/asyncio-eventloop.rst:1328
msgid ""
"the :const:`subprocess.PIPE` constant (default) which will create a new pipe "
"and connect it,"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1306
#: ../../library/asyncio-eventloop.rst:1318
#: ../../library/asyncio-eventloop.rst:1330
msgid ""
"the value ``None`` which will make the subprocess inherit the file "
"descriptor from this process"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1308
#: ../../library/asyncio-eventloop.rst:1320
#: ../../library/asyncio-eventloop.rst:1332
msgid ""
"the :const:`subprocess.DEVNULL` constant which indicates that the special :"
"data:`os.devnull` file will be used"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1311
msgid "*stdout* can be any of these:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1313
msgid ""
"a file-like object representing a pipe to be connected to the subprocess's "
"standard output stream using :meth:`~loop.connect_write_pipe`"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1323
msgid "*stderr* can be any of these:"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1325
msgid ""
"a file-like object representing a pipe to be connected to the subprocess's "
"standard error stream using :meth:`~loop.connect_write_pipe`"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1334
msgid ""
"the :const:`subprocess.STDOUT` constant which will connect the standard "
"error stream to the process' standard output stream"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1337
msgid ""
"All other keyword arguments are passed to :class:`subprocess.Popen` without "
"interpretation, except for *bufsize*, *universal_newlines*, *shell*, *text*, "
"*encoding* and *errors*, which should not be specified at all."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1342
msgid ""
"The ``asyncio`` subprocess API does not support decoding the streams as "
"text. :func:`bytes.decode` can be used to convert the bytes returned from "
"the stream to text."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1346
msgid ""
"See the constructor of the :class:`subprocess.Popen` class for documentation "
"on other arguments."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1349
msgid ""
"Returns a pair of ``(transport, protocol)``, where *transport* conforms to "
"the :class:`asyncio.SubprocessTransport` base class and *protocol* is an "
"object instantiated by the *protocol_factory*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1357
msgid ""
"Create a subprocess from *cmd*, which can be a :class:`str` or a :class:"
"`bytes` string encoded to the :ref:`filesystem encoding <filesystem-"
"encoding>`, using the platform's \"shell\" syntax."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1362
msgid ""
"This is similar to the standard library :class:`subprocess.Popen` class "
"called with ``shell=True``."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1365
msgid ""
"The *protocol_factory* must be a callable returning a subclass of the :class:"
"`SubprocessProtocol` class."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1368
msgid ""
"See :meth:`~loop.subprocess_exec` for more details about the remaining "
"arguments."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1371
msgid ""
"Returns a pair of ``(transport, protocol)``, where *transport* conforms to "
"the :class:`SubprocessTransport` base class and *protocol* is an object "
"instantiated by the *protocol_factory*."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1376
msgid ""
"It is the application's responsibility to ensure that all whitespace and "
"special characters are quoted appropriately to avoid `shell injection "
"<https://en.wikipedia.org/wiki/Shell_injection#Shell_injection>`_ "
"vulnerabilities. The :func:`shlex.quote` function can be used to properly "
"escape whitespace and special characters in strings that are going to be "
"used to construct shell commands."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1385
msgid "Callback Handles"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1389
msgid ""
"A callback wrapper object returned by :meth:`loop.call_soon`, :meth:`loop."
"call_soon_threadsafe`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1394
msgid ""
"Cancel the callback.  If the callback has already been canceled or executed, "
"this method has no effect."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1399
msgid "Return ``True`` if the callback was cancelled."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1405
msgid ""
"A callback wrapper object returned by :meth:`loop.call_later`, and :meth:"
"`loop.call_at`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1408
msgid "This class is a subclass of :class:`Handle`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1412
msgid "Return a scheduled callback time as :class:`float` seconds."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1414
msgid ""
"The time is an absolute timestamp, using the same time reference as :meth:"
"`loop.time`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1421
msgid "Server Objects"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1423
msgid ""
"Server objects are created by :meth:`loop.create_server`, :meth:`loop."
"create_unix_server`, :func:`start_server`, and :func:`start_unix_server` "
"functions."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1427
msgid "Do not instantiate the class directly."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1431
msgid ""
"*Server* objects are asynchronous context managers.  When used in an ``async "
"with`` statement, it's guaranteed that the Server object is closed and not "
"accepting new connections when the ``async with`` statement is completed::"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1444
msgid "Server object is an asynchronous context manager since Python 3.7."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1449
msgid ""
"Stop serving: close listening sockets and set the :attr:`sockets` attribute "
"to ``None``."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1452
msgid ""
"The sockets that represent existing incoming client connections are left "
"open."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1455
msgid ""
"The server is closed asynchronously, use the :meth:`wait_closed` coroutine "
"to wait until the server is closed."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1460
msgid "Return the event loop associated with the server object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1466
msgid "Start accepting connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1468
msgid ""
"This method is idempotent, so it can be called when the server is already "
"being serving."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1471
msgid ""
"The *start_serving* keyword-only parameter to :meth:`loop.create_server` "
"and :meth:`asyncio.start_server` allows creating a Server object that is not "
"accepting connections initially.  In this case ``Server.start_serving()``, "
"or :meth:`Server.serve_forever` can be used to make the Server start "
"accepting connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1482
msgid ""
"Start accepting connections until the coroutine is cancelled. Cancellation "
"of ``serve_forever`` task causes the server to be closed."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1486
msgid ""
"This method can be called if the server is already accepting connections.  "
"Only one ``serve_forever`` task can exist per one *Server* object."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1508
msgid "Return ``True`` if the server is accepting new connections."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1514
msgid "Wait until the :meth:`close` method completes."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1518
msgid "List of :class:`socket.socket` objects the server is listening on."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1520
msgid ""
"Prior to Python 3.7 ``Server.sockets`` used to return an internal list of "
"server sockets directly.  In 3.7 a copy of that list is returned."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1530
msgid "Event Loop Implementations"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1532
msgid ""
"asyncio ships with two different event loop implementations: :class:"
"`SelectorEventLoop` and :class:`ProactorEventLoop`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1535
msgid ""
"By default asyncio is configured to use :class:`SelectorEventLoop` on Unix "
"and :class:`ProactorEventLoop` on Windows."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1541
msgid "An event loop based on the :mod:`selectors` module."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1543
msgid ""
"Uses the most efficient *selector* available for the given platform.  It is "
"also possible to manually configure the exact selector implementation to be "
"used::"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1558
msgid ":ref:`Availability <availability>`: Unix, Windows."
msgstr ":ref:`適用 <availability>`：Unix、Windows。"

#: ../../library/asyncio-eventloop.rst:1563
msgid "An event loop for Windows that uses \"I/O Completion Ports\" (IOCP)."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1566
msgid ":ref:`Availability <availability>`: Windows."
msgstr ":ref:`適用 <availability>`：Windows。"

#: ../../library/asyncio-eventloop.rst:1569
msgid ""
"`MSDN documentation on I/O Completion Ports <https://docs.microsoft.com/en-"
"ca/windows/desktop/FileIO/i-o-completion-ports>`_."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1575
msgid "Abstract base class for asyncio-compliant event loops."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1577
msgid ""
"The :ref:`asyncio-event-loop-methods` section lists all methods that an "
"alternative implementation of ``AbstractEventLoop`` should have defined."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1583
msgid "Examples"
msgstr "範例"

#: ../../library/asyncio-eventloop.rst:1585
msgid ""
"Note that all examples in this section **purposefully** show how to use the "
"low-level event loop APIs, such as :meth:`loop.run_forever` and :meth:`loop."
"call_soon`.  Modern asyncio applications rarely need to be written this way; "
"consider using the high-level functions like :func:`asyncio.run`."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1595
msgid "Hello World with call_soon()"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1597
msgid ""
"An example using the :meth:`loop.call_soon` method to schedule a callback. "
"The callback displays ``\"Hello World\"`` and then stops the event loop::"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1621
msgid ""
"A similar :ref:`Hello World <coroutine>` example created with a coroutine "
"and the :func:`run` function."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1628
msgid "Display the current date with call_later()"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1630
msgid ""
"An example of a callback displaying the current date every second. The "
"callback uses the :meth:`loop.call_later` method to reschedule itself after "
"5 seconds, and then stops the event loop::"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1658
msgid ""
"A similar :ref:`current date <asyncio_example_sleep>` example created with a "
"coroutine and the :func:`run` function."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1665
msgid "Watch a file descriptor for read events"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1667
msgid ""
"Wait until a file descriptor received some data using the :meth:`loop."
"add_reader` method and then close the event loop::"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1705
msgid ""
"A similar :ref:`example <asyncio_example_create_connection>` using "
"transports, protocols, and the :meth:`loop.create_connection` method."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1709
msgid ""
"Another similar :ref:`example <asyncio_example_create_connection-streams>` "
"using the high-level :func:`asyncio.open_connection` function and streams."
msgstr ""

#: ../../library/asyncio-eventloop.rst:1717
msgid "Set signal handlers for SIGINT and SIGTERM"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1719
msgid "(This ``signals`` example only works on Unix.)"
msgstr ""

#: ../../library/asyncio-eventloop.rst:1721
msgid ""
"Register handlers for signals :py:data:`SIGINT` and :py:data:`SIGTERM` using "
"the :meth:`loop.add_signal_handler` method::"
msgstr ""