From d54cae0cf473dc9a76ac694468ed98277cd80c57 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 2 Mar 2022 00:19:09 +0000 Subject: [PATCH 1/3] sync with cpython 7dbb2f8e --- c-api/typeobj.po | 4 +- library/hashlib.po | 205 +++++++++++++++++++++++---------------------- 2 files changed, 105 insertions(+), 104 deletions(-) diff --git a/c-api/typeobj.po b/c-api/typeobj.po index 6e4c6009ec..6e17d34ee9 100644 --- a/c-api/typeobj.po +++ b/c-api/typeobj.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-02-24 00:12+0000\n" +"POT-Creation-Date: 2022-03-02 00:17+0000\n" "PO-Revision-Date: 2018-05-23 14:33+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -2008,7 +2008,7 @@ msgstr "" #: ../../c-api/typeobj.rst:1234 ../../c-api/typeobj.rst:1256 msgid "" ":const:`Py_TPFLAGS_MAPPING` and :const:`Py_TPFLAGS_SEQUENCE` are mutually " -"exclusive; it is an error enable both flags simultaneously." +"exclusive; it is an error to enable both flags simultaneously." msgstr "" #: ../../c-api/typeobj.rst:1239 diff --git a/library/hashlib.po b/library/hashlib.po index 01a41b3c25..9d99a04486 100644 --- a/library/hashlib.po +++ b/library/hashlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-01-28 00:10+0000\n" +"POT-Creation-Date: 2022-03-02 00:17+0000\n" "PO-Revision-Date: 2018-05-23 16:03+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -276,35 +276,36 @@ msgid "" "The number of *iterations* should be chosen based on the hash algorithm and " "computing power. As of 2022, hundreds of thousands of iterations of SHA-256 " "are suggested. For rationale as to why and how to choose what is best for " -"your application, read *Appendix A.2.2* of NIST-SP-800-132_." +"your application, read *Appendix A.2.2* of NIST-SP-800-132_. The answers on " +"the `stackexchange pbkdf2 iterations question`_ explain in detail." msgstr "" -#: ../../library/hashlib.rst:256 +#: ../../library/hashlib.rst:257 msgid "" "*dklen* is the length of the derived key. If *dklen* is ``None`` then the " "digest size of the hash algorithm *hash_name* is used, e.g. 64 for SHA-512." msgstr "" -#: ../../library/hashlib.rst:268 +#: ../../library/hashlib.rst:270 msgid "" "A fast implementation of *pbkdf2_hmac* is available with OpenSSL. The " "Python implementation uses an inline version of :mod:`hmac`. It is about " "three times slower and doesn't release the GIL." msgstr "" -#: ../../library/hashlib.rst:274 +#: ../../library/hashlib.rst:276 msgid "" "Slow Python implementation of *pbkdf2_hmac* is deprecated. In the future the " "function will only be available when Python is compiled with OpenSSL." msgstr "" -#: ../../library/hashlib.rst:280 +#: ../../library/hashlib.rst:282 msgid "" "The function provides scrypt password-based key derivation function as " "defined in :rfc:`7914`." msgstr "" -#: ../../library/hashlib.rst:283 +#: ../../library/hashlib.rst:285 msgid "" "*password* and *salt* must be :term:`bytes-like objects `. Applications and libraries should limit *password* to a sensible " @@ -312,138 +313,138 @@ msgid "" "source, e.g. :func:`os.urandom`." msgstr "" -#: ../../library/hashlib.rst:288 +#: ../../library/hashlib.rst:290 msgid "" "*n* is the CPU/Memory cost factor, *r* the block size, *p* parallelization " "factor and *maxmem* limits memory (OpenSSL 1.1.0 defaults to 32 MiB). " "*dklen* is the length of the derived key." msgstr "" -#: ../../library/hashlib.rst:296 +#: ../../library/hashlib.rst:298 msgid "BLAKE2" msgstr "BLAKE2" -#: ../../library/hashlib.rst:303 +#: ../../library/hashlib.rst:305 msgid "" "BLAKE2_ is a cryptographic hash function defined in :rfc:`7693` that comes " "in two flavors:" msgstr "" -#: ../../library/hashlib.rst:306 +#: ../../library/hashlib.rst:308 msgid "" "**BLAKE2b**, optimized for 64-bit platforms and produces digests of any size " "between 1 and 64 bytes," msgstr "" -#: ../../library/hashlib.rst:309 +#: ../../library/hashlib.rst:311 msgid "" "**BLAKE2s**, optimized for 8- to 32-bit platforms and produces digests of " "any size between 1 and 32 bytes." msgstr "" -#: ../../library/hashlib.rst:312 +#: ../../library/hashlib.rst:314 msgid "" "BLAKE2 supports **keyed mode** (a faster and simpler replacement for HMAC_), " "**salted hashing**, **personalization**, and **tree hashing**." msgstr "" -#: ../../library/hashlib.rst:315 +#: ../../library/hashlib.rst:317 msgid "" "Hash objects from this module follow the API of standard library's :mod:" "`hashlib` objects." msgstr "" -#: ../../library/hashlib.rst:320 +#: ../../library/hashlib.rst:322 msgid "Creating hash objects" msgstr "" -#: ../../library/hashlib.rst:322 +#: ../../library/hashlib.rst:324 msgid "New hash objects are created by calling constructor functions:" msgstr "" -#: ../../library/hashlib.rst:336 +#: ../../library/hashlib.rst:338 msgid "" "These functions return the corresponding hash objects for calculating " "BLAKE2b or BLAKE2s. They optionally take these general parameters:" msgstr "" -#: ../../library/hashlib.rst:339 +#: ../../library/hashlib.rst:341 msgid "" "*data*: initial chunk of data to hash, which must be :term:`bytes-like " "object`. It can be passed only as positional argument." msgstr "" -#: ../../library/hashlib.rst:342 +#: ../../library/hashlib.rst:344 msgid "*digest_size*: size of output digest in bytes." msgstr "" -#: ../../library/hashlib.rst:344 +#: ../../library/hashlib.rst:346 msgid "" "*key*: key for keyed hashing (up to 64 bytes for BLAKE2b, up to 32 bytes for " "BLAKE2s)." msgstr "" -#: ../../library/hashlib.rst:347 +#: ../../library/hashlib.rst:349 msgid "" "*salt*: salt for randomized hashing (up to 16 bytes for BLAKE2b, up to 8 " "bytes for BLAKE2s)." msgstr "" -#: ../../library/hashlib.rst:350 +#: ../../library/hashlib.rst:352 msgid "" "*person*: personalization string (up to 16 bytes for BLAKE2b, up to 8 bytes " "for BLAKE2s)." msgstr "" -#: ../../library/hashlib.rst:353 +#: ../../library/hashlib.rst:355 msgid "The following table shows limits for general parameters (in bytes):" msgstr "" -#: ../../library/hashlib.rst:356 +#: ../../library/hashlib.rst:358 msgid "Hash" msgstr "" -#: ../../library/hashlib.rst:356 +#: ../../library/hashlib.rst:358 msgid "digest_size" msgstr "digest_size" -#: ../../library/hashlib.rst:356 +#: ../../library/hashlib.rst:358 msgid "len(key)" msgstr "len(key)" -#: ../../library/hashlib.rst:356 +#: ../../library/hashlib.rst:358 msgid "len(salt)" msgstr "len(salt)" -#: ../../library/hashlib.rst:356 +#: ../../library/hashlib.rst:358 msgid "len(person)" msgstr "len(person)" -#: ../../library/hashlib.rst:358 +#: ../../library/hashlib.rst:360 msgid "BLAKE2b" msgstr "BLAKE2b" -#: ../../library/hashlib.rst:358 +#: ../../library/hashlib.rst:360 msgid "64" msgstr "64" -#: ../../library/hashlib.rst:358 +#: ../../library/hashlib.rst:360 msgid "16" msgstr "16" -#: ../../library/hashlib.rst:359 +#: ../../library/hashlib.rst:361 msgid "BLAKE2s" msgstr "BLAKE2s" -#: ../../library/hashlib.rst:359 +#: ../../library/hashlib.rst:361 msgid "32" msgstr "32" -#: ../../library/hashlib.rst:359 +#: ../../library/hashlib.rst:361 msgid "8" msgstr "8" -#: ../../library/hashlib.rst:364 +#: ../../library/hashlib.rst:366 msgid "" "BLAKE2 specification defines constant lengths for salt and personalization " "parameters, however, for convenience, this implementation accepts byte " @@ -453,49 +454,49 @@ msgid "" "the case for *key*.)" msgstr "" -#: ../../library/hashlib.rst:371 +#: ../../library/hashlib.rst:373 msgid "These sizes are available as module `constants`_ described below." msgstr "" -#: ../../library/hashlib.rst:373 +#: ../../library/hashlib.rst:375 msgid "" "Constructor functions also accept the following tree hashing parameters:" msgstr "" -#: ../../library/hashlib.rst:375 +#: ../../library/hashlib.rst:377 msgid "*fanout*: fanout (0 to 255, 0 if unlimited, 1 in sequential mode)." msgstr "" -#: ../../library/hashlib.rst:377 +#: ../../library/hashlib.rst:379 msgid "" "*depth*: maximal depth of tree (1 to 255, 255 if unlimited, 1 in sequential " "mode)." msgstr "" -#: ../../library/hashlib.rst:380 +#: ../../library/hashlib.rst:382 msgid "" "*leaf_size*: maximal byte length of leaf (0 to ``2**32-1``, 0 if unlimited " "or in sequential mode)." msgstr "" -#: ../../library/hashlib.rst:383 +#: ../../library/hashlib.rst:385 msgid "" "*node_offset*: node offset (0 to ``2**64-1`` for BLAKE2b, 0 to ``2**48-1`` " "for BLAKE2s, 0 for the first, leftmost, leaf, or in sequential mode)." msgstr "" -#: ../../library/hashlib.rst:386 +#: ../../library/hashlib.rst:388 msgid "" "*node_depth*: node depth (0 to 255, 0 for leaves, or in sequential mode)." msgstr "" -#: ../../library/hashlib.rst:388 +#: ../../library/hashlib.rst:390 msgid "" "*inner_size*: inner digest size (0 to 64 for BLAKE2b, 0 to 32 for BLAKE2s, 0 " "in sequential mode)." msgstr "" -#: ../../library/hashlib.rst:391 +#: ../../library/hashlib.rst:393 msgid "" "*last_node*: boolean indicating whether the processed node is the last one " "(`False` for sequential mode)." @@ -505,42 +506,42 @@ msgstr "" msgid "Explanation of tree mode parameters." msgstr "" -#: ../../library/hashlib.rst:397 +#: ../../library/hashlib.rst:399 msgid "" "See section 2.10 in `BLAKE2 specification `_ for comprehensive review of tree hashing." msgstr "" -#: ../../library/hashlib.rst:403 +#: ../../library/hashlib.rst:405 msgid "Constants" msgstr "常數" -#: ../../library/hashlib.rst:408 +#: ../../library/hashlib.rst:410 msgid "Salt length (maximum length accepted by constructors)." msgstr "" -#: ../../library/hashlib.rst:414 +#: ../../library/hashlib.rst:416 msgid "" "Personalization string length (maximum length accepted by constructors)." msgstr "" -#: ../../library/hashlib.rst:420 +#: ../../library/hashlib.rst:422 msgid "Maximum key size." msgstr "" -#: ../../library/hashlib.rst:426 +#: ../../library/hashlib.rst:428 msgid "Maximum digest size that the hash function can output." msgstr "" -#: ../../library/hashlib.rst:430 +#: ../../library/hashlib.rst:432 msgid "Examples" msgstr "範例" -#: ../../library/hashlib.rst:433 +#: ../../library/hashlib.rst:435 msgid "Simple hashing" msgstr "" -#: ../../library/hashlib.rst:435 +#: ../../library/hashlib.rst:437 msgid "" "To calculate hash of some data, you should first construct a hash object by " "calling the appropriate constructor function (:func:`blake2b` or :func:" @@ -549,41 +550,41 @@ msgid "" "`digest` (or :meth:`hexdigest` for hex-encoded string)." msgstr "" -#: ../../library/hashlib.rst:448 +#: ../../library/hashlib.rst:450 msgid "" "As a shortcut, you can pass the first chunk of data to update directly to " "the constructor as the positional argument:" msgstr "" -#: ../../library/hashlib.rst:455 +#: ../../library/hashlib.rst:457 msgid "" "You can call :meth:`hash.update` as many times as you need to iteratively " "update the hash:" msgstr "" -#: ../../library/hashlib.rst:468 +#: ../../library/hashlib.rst:470 msgid "Using different digest sizes" msgstr "" -#: ../../library/hashlib.rst:470 +#: ../../library/hashlib.rst:472 msgid "" "BLAKE2 has configurable size of digests up to 64 bytes for BLAKE2b and up to " "32 bytes for BLAKE2s. For example, to replace SHA-1 with BLAKE2b without " "changing the size of output, we can tell BLAKE2b to produce 20-byte digests:" msgstr "" -#: ../../library/hashlib.rst:484 +#: ../../library/hashlib.rst:486 msgid "" "Hash objects with different digest sizes have completely different outputs " "(shorter hashes are *not* prefixes of longer hashes); BLAKE2b and BLAKE2s " "produce different outputs even if the output length is the same:" msgstr "" -#: ../../library/hashlib.rst:500 +#: ../../library/hashlib.rst:502 msgid "Keyed hashing" msgstr "" -#: ../../library/hashlib.rst:502 +#: ../../library/hashlib.rst:504 msgid "" "Keyed hashing can be used for authentication as a faster and simpler " "replacement for `Hash-based message authentication code `_)" msgstr "" -#: ../../library/hashlib.rst:586 +#: ../../library/hashlib.rst:588 msgid "" "In BLAKE2 the salt is processed as a one-time input to the hash function " "during initialization, rather than as an input to each compression function." msgstr "" -#: ../../library/hashlib.rst:591 +#: ../../library/hashlib.rst:593 msgid "" "*Salted hashing* (or just hashing) with BLAKE2 or any other general-purpose " "cryptographic hash function, such as SHA-256, is not suitable for hashing " "passwords. See `BLAKE2 FAQ `_ for more information." msgstr "" -#: ../../library/hashlib.rst:614 +#: ../../library/hashlib.rst:616 msgid "Personalization" msgstr "" -#: ../../library/hashlib.rst:616 +#: ../../library/hashlib.rst:618 msgid "" "Sometimes it is useful to force hash function to produce different digests " "for the same input for different purposes. Quoting the authors of the Skein " "hash function:" msgstr "" -#: ../../library/hashlib.rst:620 +#: ../../library/hashlib.rst:622 msgid "" "We recommend that all application designers seriously consider doing this; " "we have seen many protocols where a hash that is computed in one part of the " @@ -681,41 +682,41 @@ msgid "" "hash function used in the protocol summarily stops this type of attack." msgstr "" -#: ../../library/hashlib.rst:627 +#: ../../library/hashlib.rst:629 msgid "" "(`The Skein Hash Function Family `_, p. 21)" msgstr "" -#: ../../library/hashlib.rst:631 +#: ../../library/hashlib.rst:633 msgid "BLAKE2 can be personalized by passing bytes to the *person* argument::" msgstr "" -#: ../../library/hashlib.rst:645 +#: ../../library/hashlib.rst:647 msgid "" "Personalization together with the keyed mode can also be used to derive " "different keys from a single one." msgstr "" -#: ../../library/hashlib.rst:659 +#: ../../library/hashlib.rst:661 msgid "Tree mode" msgstr "" -#: ../../library/hashlib.rst:661 +#: ../../library/hashlib.rst:663 msgid "Here's an example of hashing a minimal tree with two leaf nodes::" msgstr "" -#: ../../library/hashlib.rst:667 +#: ../../library/hashlib.rst:669 msgid "" "This example uses 64-byte internal digests, and returns the 32-byte final " "digest::" msgstr "" -#: ../../library/hashlib.rst:697 +#: ../../library/hashlib.rst:699 msgid "Credits" msgstr "" -#: ../../library/hashlib.rst:699 +#: ../../library/hashlib.rst:701 msgid "" "BLAKE2_ was designed by *Jean-Philippe Aumasson*, *Samuel Neves*, *Zooko " "Wilcox-O'Hearn*, and *Christian Winnerlein* based on SHA-3_ finalist BLAKE_ " @@ -723,79 +724,79 @@ msgid "" "*Raphael C.-W. Phan*." msgstr "" -#: ../../library/hashlib.rst:704 +#: ../../library/hashlib.rst:706 msgid "" "It uses core algorithm from ChaCha_ cipher designed by *Daniel J. " "Bernstein*." msgstr "" -#: ../../library/hashlib.rst:706 +#: ../../library/hashlib.rst:708 msgid "" "The stdlib implementation is based on pyblake2_ module. It was written by " "*Dmitry Chestnykh* based on C implementation written by *Samuel Neves*. The " "documentation was copied from pyblake2_ and written by *Dmitry Chestnykh*." msgstr "" -#: ../../library/hashlib.rst:710 +#: ../../library/hashlib.rst:712 msgid "The C code was partly rewritten for Python by *Christian Heimes*." msgstr "" -#: ../../library/hashlib.rst:712 +#: ../../library/hashlib.rst:714 msgid "" "The following public domain dedication applies for both C hash function " "implementation, extension code, and this documentation:" msgstr "" -#: ../../library/hashlib.rst:715 +#: ../../library/hashlib.rst:717 msgid "" "To the extent possible under law, the author(s) have dedicated all copyright " "and related and neighboring rights to this software to the public domain " "worldwide. This software is distributed without any warranty." msgstr "" -#: ../../library/hashlib.rst:719 +#: ../../library/hashlib.rst:721 msgid "" "You should have received a copy of the CC0 Public Domain Dedication along " "with this software. If not, see https://creativecommons.org/publicdomain/" "zero/1.0/." msgstr "" -#: ../../library/hashlib.rst:723 +#: ../../library/hashlib.rst:725 msgid "" "The following people have helped with development or contributed their " "changes to the project and the public domain according to the Creative " "Commons Public Domain Dedication 1.0 Universal:" msgstr "" -#: ../../library/hashlib.rst:727 +#: ../../library/hashlib.rst:729 msgid "*Alexandr Sokolovskiy*" msgstr "" -#: ../../library/hashlib.rst:742 +#: ../../library/hashlib.rst:744 msgid "Module :mod:`hmac`" msgstr ":mod:`hmac` 模組" -#: ../../library/hashlib.rst:742 +#: ../../library/hashlib.rst:744 msgid "A module to generate message authentication codes using hashes." msgstr "" -#: ../../library/hashlib.rst:745 +#: ../../library/hashlib.rst:747 msgid "Module :mod:`base64`" msgstr ":mod:`base64` 模組" -#: ../../library/hashlib.rst:745 +#: ../../library/hashlib.rst:747 msgid "Another way to encode binary hashes for non-binary environments." msgstr "" -#: ../../library/hashlib.rst:748 +#: ../../library/hashlib.rst:750 msgid "https://blake2.net" msgstr "https://blake2.net" -#: ../../library/hashlib.rst:748 +#: ../../library/hashlib.rst:750 msgid "Official BLAKE2 website." msgstr "BLAKE2 官方網站。" -#: ../../library/hashlib.rst:751 +#: ../../library/hashlib.rst:753 msgid "" "https://csrc.nist.gov/csrc/media/publications/fips/180/2/archive/2002-08-01/" "documents/fips180-2.pdf" @@ -803,11 +804,11 @@ msgstr "" "https://csrc.nist.gov/csrc/media/publications/fips/180/2/archive/2002-08-01/" "documents/fips180-2.pdf" -#: ../../library/hashlib.rst:751 +#: ../../library/hashlib.rst:753 msgid "The FIPS 180-2 publication on Secure Hash Algorithms." msgstr "" -#: ../../library/hashlib.rst:755 +#: ../../library/hashlib.rst:757 msgid "" "https://en.wikipedia.org/wiki/" "Cryptographic_hash_function#Cryptographic_hash_algorithms" @@ -815,25 +816,25 @@ msgstr "" "https://en.wikipedia.org/wiki/" "Cryptographic_hash_function#Cryptographic_hash_algorithms" -#: ../../library/hashlib.rst:754 +#: ../../library/hashlib.rst:756 msgid "" "Wikipedia article with information on which algorithms have known issues and " "what that means regarding their use." msgstr "" -#: ../../library/hashlib.rst:758 +#: ../../library/hashlib.rst:760 msgid "https://www.ietf.org/rfc/rfc8018.txt" msgstr "https://www.ietf.org/rfc/rfc8018.txt" -#: ../../library/hashlib.rst:758 +#: ../../library/hashlib.rst:760 msgid "PKCS #5: Password-Based Cryptography Specification Version 2.1" msgstr "" -#: ../../library/hashlib.rst:760 +#: ../../library/hashlib.rst:762 msgid "" "https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-132.pdf" msgstr "" -#: ../../library/hashlib.rst:761 +#: ../../library/hashlib.rst:763 msgid "NIST Recommendation for Password-Based Key Derivation." msgstr "" From 3bd8990cdd4e5d4d04db2b9ab61699c99f8615f6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 3 Mar 2022 00:15:52 +0000 Subject: [PATCH 2/3] sync with cpython eb65e46b --- library/inspect.po | 520 ++++++++++++++++++++++----------------------- 1 file changed, 260 insertions(+), 260 deletions(-) diff --git a/library/inspect.po b/library/inspect.po index 3915e00ae1..d4a86c4d49 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-10-26 16:47+0000\n" +"POT-Creation-Date: 2022-03-03 00:13+0000\n" "PO-Revision-Date: 2018-05-23 16:04+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -74,13 +74,13 @@ msgstr "模組" #: ../../library/inspect.rst:43 ../../library/inspect.rst:48 #: ../../library/inspect.rst:58 ../../library/inspect.rst:76 -#: ../../library/inspect.rst:233 +#: ../../library/inspect.rst:234 msgid "__doc__" msgstr "__doc__" #: ../../library/inspect.rst:43 ../../library/inspect.rst:48 #: ../../library/inspect.rst:58 ../../library/inspect.rst:76 -#: ../../library/inspect.rst:233 +#: ../../library/inspect.rst:234 msgid "documentation string" msgstr "" @@ -97,8 +97,8 @@ msgid "class" msgstr "" #: ../../library/inspect.rst:50 ../../library/inspect.rst:60 -#: ../../library/inspect.rst:78 ../../library/inspect.rst:202 -#: ../../library/inspect.rst:216 ../../library/inspect.rst:235 +#: ../../library/inspect.rst:78 ../../library/inspect.rst:203 +#: ../../library/inspect.rst:217 ../../library/inspect.rst:236 msgid "__name__" msgstr "__name__" @@ -107,14 +107,14 @@ msgid "name with which this class was defined" msgstr "" #: ../../library/inspect.rst:53 ../../library/inspect.rst:63 -#: ../../library/inspect.rst:81 ../../library/inspect.rst:204 -#: ../../library/inspect.rst:218 ../../library/inspect.rst:238 +#: ../../library/inspect.rst:81 ../../library/inspect.rst:205 +#: ../../library/inspect.rst:219 ../../library/inspect.rst:239 msgid "__qualname__" msgstr "__qualname__" #: ../../library/inspect.rst:53 ../../library/inspect.rst:63 -#: ../../library/inspect.rst:81 ../../library/inspect.rst:204 -#: ../../library/inspect.rst:218 ../../library/inspect.rst:238 +#: ../../library/inspect.rst:81 ../../library/inspect.rst:205 +#: ../../library/inspect.rst:219 ../../library/inspect.rst:239 msgid "qualified name" msgstr "" @@ -143,7 +143,7 @@ msgstr "__func__" msgid "function object containing implementation of method" msgstr "" -#: ../../library/inspect.rst:69 ../../library/inspect.rst:240 +#: ../../library/inspect.rst:69 ../../library/inspect.rst:241 msgid "__self__" msgstr "__self__" @@ -253,8 +253,8 @@ msgstr "tb_next" msgid "next inner traceback object (called by this level)" msgstr "" -#: ../../library/inspect.rst:122 ../../library/inspect.rst:206 -#: ../../library/inspect.rst:223 +#: ../../library/inspect.rst:122 ../../library/inspect.rst:207 +#: ../../library/inspect.rst:224 msgid "frame" msgstr "" @@ -314,8 +314,8 @@ msgstr "f_trace" msgid "tracing function for this frame, or ``None``" msgstr "" -#: ../../library/inspect.rst:146 ../../library/inspect.rst:210 -#: ../../library/inspect.rst:227 +#: ../../library/inspect.rst:146 ../../library/inspect.rst:211 +#: ../../library/inspect.rst:228 msgid "code" msgstr "" @@ -423,132 +423,132 @@ msgid "co_names" msgstr "co_names" #: ../../library/inspect.rst:190 -msgid "tuple of names of local variables" +msgid "tuple of names other than arguments and function locals" msgstr "" -#: ../../library/inspect.rst:193 +#: ../../library/inspect.rst:194 msgid "co_nlocals" msgstr "co_nlocals" -#: ../../library/inspect.rst:193 +#: ../../library/inspect.rst:194 msgid "number of local variables" msgstr "" -#: ../../library/inspect.rst:195 +#: ../../library/inspect.rst:196 msgid "co_stacksize" msgstr "co_stacksize" -#: ../../library/inspect.rst:195 +#: ../../library/inspect.rst:196 msgid "virtual machine stack space required" msgstr "" -#: ../../library/inspect.rst:198 +#: ../../library/inspect.rst:199 msgid "co_varnames" msgstr "co_varnames" -#: ../../library/inspect.rst:198 +#: ../../library/inspect.rst:199 msgid "tuple of names of arguments and local variables" msgstr "" -#: ../../library/inspect.rst:202 +#: ../../library/inspect.rst:203 msgid "generator" msgstr "" -#: ../../library/inspect.rst:202 ../../library/inspect.rst:216 +#: ../../library/inspect.rst:203 ../../library/inspect.rst:217 msgid "name" msgstr "" -#: ../../library/inspect.rst:206 +#: ../../library/inspect.rst:207 msgid "gi_frame" msgstr "gi_frame" -#: ../../library/inspect.rst:208 +#: ../../library/inspect.rst:209 msgid "gi_running" msgstr "gi_running" -#: ../../library/inspect.rst:208 +#: ../../library/inspect.rst:209 msgid "is the generator running?" msgstr "" -#: ../../library/inspect.rst:210 +#: ../../library/inspect.rst:211 msgid "gi_code" msgstr "gi_code" -#: ../../library/inspect.rst:212 +#: ../../library/inspect.rst:213 msgid "gi_yieldfrom" msgstr "gi_yieldfrom" -#: ../../library/inspect.rst:212 +#: ../../library/inspect.rst:213 msgid "object being iterated by ``yield from``, or ``None``" msgstr "" -#: ../../library/inspect.rst:216 +#: ../../library/inspect.rst:217 msgid "coroutine" msgstr "" -#: ../../library/inspect.rst:220 +#: ../../library/inspect.rst:221 msgid "cr_await" msgstr "cr_await" -#: ../../library/inspect.rst:220 +#: ../../library/inspect.rst:221 msgid "object being awaited on, or ``None``" msgstr "" -#: ../../library/inspect.rst:223 +#: ../../library/inspect.rst:224 msgid "cr_frame" msgstr "cr_frame" -#: ../../library/inspect.rst:225 +#: ../../library/inspect.rst:226 msgid "cr_running" msgstr "cr_running" -#: ../../library/inspect.rst:225 +#: ../../library/inspect.rst:226 msgid "is the coroutine running?" msgstr "" -#: ../../library/inspect.rst:227 +#: ../../library/inspect.rst:228 msgid "cr_code" msgstr "cr_code" -#: ../../library/inspect.rst:229 +#: ../../library/inspect.rst:230 msgid "cr_origin" msgstr "cr_origin" -#: ../../library/inspect.rst:229 +#: ../../library/inspect.rst:230 msgid "where coroutine was created, or ``None``. See |coroutine-origin-link|" msgstr "" -#: ../../library/inspect.rst:233 +#: ../../library/inspect.rst:234 msgid "builtin" msgstr "" -#: ../../library/inspect.rst:235 +#: ../../library/inspect.rst:236 msgid "original name of this function or method" msgstr "" -#: ../../library/inspect.rst:240 +#: ../../library/inspect.rst:241 msgid "instance to which a method is bound, or ``None``" msgstr "" -#: ../../library/inspect.rst:247 +#: ../../library/inspect.rst:248 msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators." msgstr "" -#: ../../library/inspect.rst:249 +#: ../../library/inspect.rst:250 msgid "" "The ``__name__`` attribute of generators is now set from the function name, " "instead of the code name, and it can now be modified." msgstr "" -#: ../../library/inspect.rst:254 +#: ../../library/inspect.rst:255 msgid "Add ``cr_origin`` attribute to coroutines." msgstr "" -#: ../../library/inspect.rst:258 +#: ../../library/inspect.rst:259 msgid "Add ``__builtins__`` attribute to functions." msgstr "" -#: ../../library/inspect.rst:262 +#: ../../library/inspect.rst:263 msgid "" "Return all the members of an object in a list of ``(name, value)`` pairs " "sorted by name. If the optional *predicate* argument—which will be called " @@ -556,14 +556,14 @@ msgid "" "the predicate returns a true value are included." msgstr "" -#: ../../library/inspect.rst:269 +#: ../../library/inspect.rst:270 msgid "" ":func:`getmembers` will only return class attributes defined in the " "metaclass when the argument is a class and those attributes have been listed " "in the metaclass' custom :meth:`__dir__`." msgstr "" -#: ../../library/inspect.rst:276 +#: ../../library/inspect.rst:277 msgid "" "Return the name of the module named by the file *path*, without including " "the names of enclosing packages. The file extension is checked against all " @@ -572,134 +572,134 @@ msgid "" "``None`` is returned." msgstr "" -#: ../../library/inspect.rst:282 +#: ../../library/inspect.rst:283 msgid "" "Note that this function *only* returns a meaningful name for actual Python " "modules - paths that potentially refer to Python packages will still return " "``None``." msgstr "" -#: ../../library/inspect.rst:286 +#: ../../library/inspect.rst:287 msgid "The function is based directly on :mod:`importlib`." msgstr "" -#: ../../library/inspect.rst:292 +#: ../../library/inspect.rst:293 msgid "Return ``True`` if the object is a module." msgstr "" -#: ../../library/inspect.rst:297 +#: ../../library/inspect.rst:298 msgid "" "Return ``True`` if the object is a class, whether built-in or created in " "Python code." msgstr "" -#: ../../library/inspect.rst:303 +#: ../../library/inspect.rst:304 msgid "Return ``True`` if the object is a bound method written in Python." msgstr "" -#: ../../library/inspect.rst:308 +#: ../../library/inspect.rst:309 msgid "" "Return ``True`` if the object is a Python function, which includes functions " "created by a :term:`lambda` expression." msgstr "" -#: ../../library/inspect.rst:314 +#: ../../library/inspect.rst:315 msgid "Return ``True`` if the object is a Python generator function." msgstr "" -#: ../../library/inspect.rst:316 +#: ../../library/inspect.rst:317 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a Python generator function." msgstr "" -#: ../../library/inspect.rst:323 +#: ../../library/inspect.rst:324 msgid "Return ``True`` if the object is a generator." msgstr "" -#: ../../library/inspect.rst:328 +#: ../../library/inspect.rst:329 msgid "" "Return ``True`` if the object is a :term:`coroutine function` (a function " "defined with an :keyword:`async def` syntax)." msgstr "" -#: ../../library/inspect.rst:333 +#: ../../library/inspect.rst:334 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a :term:`coroutine function`." msgstr "" -#: ../../library/inspect.rst:340 +#: ../../library/inspect.rst:341 msgid "" "Return ``True`` if the object is a :term:`coroutine` created by an :keyword:" "`async def` function." msgstr "" -#: ../../library/inspect.rst:348 +#: ../../library/inspect.rst:349 msgid "" "Return ``True`` if the object can be used in :keyword:`await` expression." msgstr "" -#: ../../library/inspect.rst:350 +#: ../../library/inspect.rst:351 msgid "" "Can also be used to distinguish generator-based coroutines from regular " "generators::" msgstr "" -#: ../../library/inspect.rst:367 +#: ../../library/inspect.rst:368 msgid "" "Return ``True`` if the object is an :term:`asynchronous generator` function, " "for example::" msgstr "" -#: ../../library/inspect.rst:378 +#: ../../library/inspect.rst:379 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a :term:`asynchronous generator` function." msgstr "" -#: ../../library/inspect.rst:385 +#: ../../library/inspect.rst:386 msgid "" "Return ``True`` if the object is an :term:`asynchronous generator iterator` " "created by an :term:`asynchronous generator` function." msgstr "" -#: ../../library/inspect.rst:392 +#: ../../library/inspect.rst:393 msgid "Return ``True`` if the object is a traceback." msgstr "" -#: ../../library/inspect.rst:397 +#: ../../library/inspect.rst:398 msgid "Return ``True`` if the object is a frame." msgstr "" -#: ../../library/inspect.rst:402 +#: ../../library/inspect.rst:403 msgid "Return ``True`` if the object is a code." msgstr "" -#: ../../library/inspect.rst:407 +#: ../../library/inspect.rst:408 msgid "" "Return ``True`` if the object is a built-in function or a bound built-in " "method." msgstr "" -#: ../../library/inspect.rst:412 +#: ../../library/inspect.rst:413 msgid "" "Return ``True`` if the object is a user-defined or built-in function or " "method." msgstr "" -#: ../../library/inspect.rst:417 +#: ../../library/inspect.rst:418 msgid "Return ``True`` if the object is an abstract base class." msgstr "" -#: ../../library/inspect.rst:422 +#: ../../library/inspect.rst:423 msgid "" "Return ``True`` if the object is a method descriptor, but not if :func:" "`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are " "true." msgstr "" -#: ../../library/inspect.rst:426 +#: ../../library/inspect.rst:427 msgid "" "This, for example, is true of ``int.__add__``. An object passing this test " "has a :meth:`~object.__get__` method but not a :meth:`~object.__set__` " @@ -707,7 +707,7 @@ msgid "" "__name__` attribute is usually sensible, and :attr:`__doc__` often is." msgstr "" -#: ../../library/inspect.rst:432 +#: ../../library/inspect.rst:433 msgid "" "Methods implemented via descriptors that also pass one of the other tests " "return ``False`` from the :func:`ismethoddescriptor` test, simply because " @@ -715,11 +715,11 @@ msgid "" "`__func__` attribute (etc) when an object passes :func:`ismethod`." msgstr "" -#: ../../library/inspect.rst:440 +#: ../../library/inspect.rst:441 msgid "Return ``True`` if the object is a data descriptor." msgstr "" -#: ../../library/inspect.rst:442 +#: ../../library/inspect.rst:443 msgid "" "Data descriptors have a :attr:`~object.__set__` or a :attr:`~object." "__delete__` method. Examples are properties (defined in Python), getsets, " @@ -730,33 +730,33 @@ msgid "" "and members have both of these attributes), but this is not guaranteed." msgstr "" -#: ../../library/inspect.rst:453 +#: ../../library/inspect.rst:454 msgid "Return ``True`` if the object is a getset descriptor." msgstr "" -#: ../../library/inspect.rst:457 +#: ../../library/inspect.rst:458 msgid "" "getsets are attributes defined in extension modules via :c:type:" "`PyGetSetDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: ../../library/inspect.rst:464 +#: ../../library/inspect.rst:465 msgid "Return ``True`` if the object is a member descriptor." msgstr "" -#: ../../library/inspect.rst:468 +#: ../../library/inspect.rst:469 msgid "" "Member descriptors are attributes defined in extension modules via :c:type:" "`PyMemberDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: ../../library/inspect.rst:476 +#: ../../library/inspect.rst:477 msgid "Retrieving source code" msgstr "" -#: ../../library/inspect.rst:480 +#: ../../library/inspect.rst:481 msgid "" "Get the documentation string for an object, cleaned up with :func:" "`cleandoc`. If the documentation string for an object is not provided and " @@ -764,11 +764,11 @@ msgid "" "documentation string from the inheritance hierarchy." msgstr "" -#: ../../library/inspect.rst:485 +#: ../../library/inspect.rst:486 msgid "Documentation strings are now inherited if not overridden." msgstr "" -#: ../../library/inspect.rst:491 +#: ../../library/inspect.rst:492 msgid "" "Return in a single string any lines of comments immediately preceding the " "object's source code (for a class, function, or method), or at the top of " @@ -777,25 +777,25 @@ msgid "" "been defined in C or the interactive shell." msgstr "" -#: ../../library/inspect.rst:500 +#: ../../library/inspect.rst:501 msgid "" "Return the name of the (text or binary) file in which an object was defined. " "This will fail with a :exc:`TypeError` if the object is a built-in module, " "class, or function." msgstr "" -#: ../../library/inspect.rst:507 +#: ../../library/inspect.rst:508 msgid "Try to guess which module an object was defined in." msgstr "" -#: ../../library/inspect.rst:512 +#: ../../library/inspect.rst:513 msgid "" "Return the name of the Python source file in which an object was defined. " "This will fail with a :exc:`TypeError` if the object is a built-in module, " "class, or function." msgstr "" -#: ../../library/inspect.rst:519 +#: ../../library/inspect.rst:520 msgid "" "Return a list of source lines and starting line number for an object. The " "argument may be a module, class, method, function, traceback, frame, or code " @@ -805,13 +805,13 @@ msgid "" "code cannot be retrieved." msgstr "" -#: ../../library/inspect.rst:526 ../../library/inspect.rst:538 +#: ../../library/inspect.rst:527 ../../library/inspect.rst:539 msgid "" ":exc:`OSError` is raised instead of :exc:`IOError`, now an alias of the " "former." msgstr "" -#: ../../library/inspect.rst:533 +#: ../../library/inspect.rst:534 msgid "" "Return the text of the source code for an object. The argument may be a " "module, class, method, function, traceback, frame, or code object. The " @@ -819,13 +819,13 @@ msgid "" "the source code cannot be retrieved." msgstr "" -#: ../../library/inspect.rst:545 +#: ../../library/inspect.rst:546 msgid "" "Clean up indentation from docstrings that are indented to line up with " "blocks of code." msgstr "" -#: ../../library/inspect.rst:548 +#: ../../library/inspect.rst:549 msgid "" "All leading whitespace is removed from the first line. Any leading " "whitespace that can be uniformly removed from the second line onwards is " @@ -833,28 +833,28 @@ msgid "" "Also, all tabs are expanded to spaces." msgstr "" -#: ../../library/inspect.rst:557 +#: ../../library/inspect.rst:558 msgid "Introspecting callables with the Signature object" msgstr "" -#: ../../library/inspect.rst:561 +#: ../../library/inspect.rst:562 msgid "" "The Signature object represents the call signature of a callable object and " "its return annotation. To retrieve a Signature object, use the :func:" "`signature` function." msgstr "" -#: ../../library/inspect.rst:567 +#: ../../library/inspect.rst:568 msgid "Return a :class:`Signature` object for the given ``callable``::" msgstr "" -#: ../../library/inspect.rst:584 +#: ../../library/inspect.rst:585 msgid "" "Accepts a wide range of Python callables, from plain functions and classes " "to :func:`functools.partial` objects." msgstr "" -#: ../../library/inspect.rst:587 +#: ../../library/inspect.rst:588 msgid "" "For objects defined in modules using stringized annotations (``from " "__future__ import annotations``), :func:`signature` will attempt to " @@ -865,7 +865,7 @@ msgid "" "instructions on how to use these parameters." msgstr "" -#: ../../library/inspect.rst:596 +#: ../../library/inspect.rst:597 msgid "" "Raises :exc:`ValueError` if no signature can be provided, and :exc:" "`TypeError` if that type of object is not supported. Also, if the " @@ -874,39 +874,39 @@ msgid "" "exception." msgstr "" -#: ../../library/inspect.rst:602 +#: ../../library/inspect.rst:603 msgid "" "A slash(/) in the signature of a function denotes that the parameters prior " "to it are positional-only. For more info, see :ref:`the FAQ entry on " "positional-only parameters `." msgstr "" -#: ../../library/inspect.rst:606 +#: ../../library/inspect.rst:607 msgid "" "``follow_wrapped`` parameter. Pass ``False`` to get a signature of " "``callable`` specifically (``callable.__wrapped__`` will not be used to " "unwrap decorated callables.)" msgstr "" -#: ../../library/inspect.rst:611 +#: ../../library/inspect.rst:612 msgid "``globals``, ``locals``, and ``eval_str`` parameters." msgstr "" -#: ../../library/inspect.rst:616 +#: ../../library/inspect.rst:617 msgid "" "Some callables may not be introspectable in certain implementations of " "Python. For example, in CPython, some built-in functions defined in C " "provide no metadata about their arguments." msgstr "" -#: ../../library/inspect.rst:623 +#: ../../library/inspect.rst:624 msgid "" "A Signature object represents the call signature of a function and its " "return annotation. For each parameter accepted by the function it stores a :" "class:`Parameter` object in its :attr:`parameters` collection." msgstr "" -#: ../../library/inspect.rst:627 +#: ../../library/inspect.rst:628 msgid "" "The optional *parameters* argument is a sequence of :class:`Parameter` " "objects, which is validated to check that there are no parameters with " @@ -915,54 +915,54 @@ msgid "" "defaults follow parameters without defaults." msgstr "" -#: ../../library/inspect.rst:633 +#: ../../library/inspect.rst:634 msgid "" "The optional *return_annotation* argument, can be an arbitrary Python " "object, is the \"return\" annotation of the callable." msgstr "" -#: ../../library/inspect.rst:636 +#: ../../library/inspect.rst:637 msgid "" "Signature objects are *immutable*. Use :meth:`Signature.replace` to make a " "modified copy." msgstr "" -#: ../../library/inspect.rst:639 +#: ../../library/inspect.rst:640 msgid "Signature objects are picklable and hashable." msgstr "" -#: ../../library/inspect.rst:644 +#: ../../library/inspect.rst:645 msgid "A special class-level marker to specify absence of a return annotation." msgstr "" -#: ../../library/inspect.rst:648 +#: ../../library/inspect.rst:649 msgid "" "An ordered mapping of parameters' names to the corresponding :class:" "`Parameter` objects. Parameters appear in strict definition order, " "including keyword-only parameters." msgstr "" -#: ../../library/inspect.rst:652 ../../library/inspect.rst:996 +#: ../../library/inspect.rst:653 ../../library/inspect.rst:997 msgid "" "Python only explicitly guaranteed that it preserved the declaration order of " "keyword-only parameters as of version 3.7, although in practice this order " "had always been preserved in Python 3." msgstr "" -#: ../../library/inspect.rst:659 +#: ../../library/inspect.rst:660 msgid "" "The \"return\" annotation for the callable. If the callable has no \"return" "\" annotation, this attribute is set to :attr:`Signature.empty`." msgstr "" -#: ../../library/inspect.rst:664 +#: ../../library/inspect.rst:665 msgid "" "Create a mapping from positional and keyword arguments to parameters. " "Returns :class:`BoundArguments` if ``*args`` and ``**kwargs`` match the " "signature, or raises a :exc:`TypeError`." msgstr "" -#: ../../library/inspect.rst:670 +#: ../../library/inspect.rst:671 msgid "" "Works the same way as :meth:`Signature.bind`, but allows the omission of " "some required arguments (mimics :func:`functools.partial` behavior.) " @@ -970,7 +970,7 @@ msgid "" "arguments do not match the signature." msgstr "" -#: ../../library/inspect.rst:677 +#: ../../library/inspect.rst:678 msgid "" "Create a new Signature instance based on the instance replace was invoked " "on. It is possible to pass different ``parameters`` and/or " @@ -979,7 +979,7 @@ msgid "" "attr:`Signature.empty`." msgstr "" -#: ../../library/inspect.rst:694 +#: ../../library/inspect.rst:695 msgid "" "Return a :class:`Signature` (or its subclass) object for a given callable " "``obj``. Pass ``follow_wrapped=False`` to get a signature of ``obj`` " @@ -987,138 +987,138 @@ msgid "" "will be used as the namespaces when resolving annotations." msgstr "" -#: ../../library/inspect.rst:699 +#: ../../library/inspect.rst:700 msgid "This method simplifies subclassing of :class:`Signature`::" msgstr "" -#: ../../library/inspect.rst:708 +#: ../../library/inspect.rst:709 msgid "``globalns`` and ``localns`` parameters." msgstr "" -#: ../../library/inspect.rst:714 +#: ../../library/inspect.rst:715 msgid "" "Parameter objects are *immutable*. Instead of modifying a Parameter object, " "you can use :meth:`Parameter.replace` to create a modified copy." msgstr "" -#: ../../library/inspect.rst:717 +#: ../../library/inspect.rst:718 msgid "Parameter objects are picklable and hashable." msgstr "" -#: ../../library/inspect.rst:722 +#: ../../library/inspect.rst:723 msgid "" "A special class-level marker to specify absence of default values and " "annotations." msgstr "" -#: ../../library/inspect.rst:727 +#: ../../library/inspect.rst:728 msgid "" "The name of the parameter as a string. The name must be a valid Python " "identifier." msgstr "" -#: ../../library/inspect.rst:732 +#: ../../library/inspect.rst:733 msgid "" "CPython generates implicit parameter names of the form ``.0`` on the code " "objects used to implement comprehensions and generator expressions." msgstr "" -#: ../../library/inspect.rst:736 +#: ../../library/inspect.rst:737 msgid "" "These parameter names are exposed by this module as names like ``implicit0``." msgstr "" -#: ../../library/inspect.rst:742 +#: ../../library/inspect.rst:743 msgid "" "The default value for the parameter. If the parameter has no default value, " "this attribute is set to :attr:`Parameter.empty`." msgstr "" -#: ../../library/inspect.rst:747 +#: ../../library/inspect.rst:748 msgid "" "The annotation for the parameter. If the parameter has no annotation, this " "attribute is set to :attr:`Parameter.empty`." msgstr "" -#: ../../library/inspect.rst:752 +#: ../../library/inspect.rst:753 msgid "" "Describes how argument values are bound to the parameter. Possible values " "(accessible via :class:`Parameter`, like ``Parameter.KEYWORD_ONLY``):" msgstr "" -#: ../../library/inspect.rst:758 +#: ../../library/inspect.rst:759 msgid "Name" msgstr "名稱" -#: ../../library/inspect.rst:758 +#: ../../library/inspect.rst:759 msgid "Meaning" msgstr "意義" -#: ../../library/inspect.rst:760 +#: ../../library/inspect.rst:761 msgid "*POSITIONAL_ONLY*" msgstr "*POSITIONAL_ONLY*" -#: ../../library/inspect.rst:760 +#: ../../library/inspect.rst:761 msgid "" "Value must be supplied as a positional argument. Positional only parameters " "are those which appear before a ``/`` entry (if present) in a Python " "function definition." msgstr "" -#: ../../library/inspect.rst:765 +#: ../../library/inspect.rst:766 msgid "*POSITIONAL_OR_KEYWORD*" msgstr "*POSITIONAL_OR_KEYWORD*" -#: ../../library/inspect.rst:765 +#: ../../library/inspect.rst:766 msgid "" "Value may be supplied as either a keyword or positional argument (this is " "the standard binding behaviour for functions implemented in Python.)" msgstr "" -#: ../../library/inspect.rst:770 +#: ../../library/inspect.rst:771 msgid "*VAR_POSITIONAL*" msgstr "*VAR_POSITIONAL*" -#: ../../library/inspect.rst:770 +#: ../../library/inspect.rst:771 msgid "" "A tuple of positional arguments that aren't bound to any other parameter. " "This corresponds to a ``*args`` parameter in a Python function definition." msgstr "" -#: ../../library/inspect.rst:775 +#: ../../library/inspect.rst:776 msgid "*KEYWORD_ONLY*" msgstr "*KEYWORD_ONLY*" -#: ../../library/inspect.rst:775 +#: ../../library/inspect.rst:776 msgid "" "Value must be supplied as a keyword argument. Keyword only parameters are " "those which appear after a ``*`` or ``*args`` entry in a Python function " "definition." msgstr "" -#: ../../library/inspect.rst:780 +#: ../../library/inspect.rst:781 msgid "*VAR_KEYWORD*" msgstr "*VAR_KEYWORD*" -#: ../../library/inspect.rst:780 +#: ../../library/inspect.rst:781 msgid "" "A dict of keyword arguments that aren't bound to any other parameter. This " "corresponds to a ``**kwargs`` parameter in a Python function definition." msgstr "" -#: ../../library/inspect.rst:786 +#: ../../library/inspect.rst:787 msgid "Example: print all keyword-only arguments without default values::" msgstr "" -#: ../../library/inspect.rst:800 +#: ../../library/inspect.rst:801 msgid "Describes a enum value of Parameter.kind." msgstr "" -#: ../../library/inspect.rst:804 +#: ../../library/inspect.rst:805 msgid "Example: print all descriptions of arguments::" msgstr "" -#: ../../library/inspect.rst:819 +#: ../../library/inspect.rst:820 msgid "" "Create a new Parameter instance based on the instance replaced was invoked " "on. To override a :class:`Parameter` attribute, pass the corresponding " @@ -1126,94 +1126,94 @@ msgid "" "pass :attr:`Parameter.empty`." msgstr "" -#: ../../library/inspect.rst:837 +#: ../../library/inspect.rst:838 msgid "" "In Python 3.3 Parameter objects were allowed to have ``name`` set to " "``None`` if their ``kind`` was set to ``POSITIONAL_ONLY``. This is no longer " "permitted." msgstr "" -#: ../../library/inspect.rst:844 +#: ../../library/inspect.rst:845 msgid "" "Result of a :meth:`Signature.bind` or :meth:`Signature.bind_partial` call. " "Holds the mapping of arguments to the function's parameters." msgstr "" -#: ../../library/inspect.rst:849 +#: ../../library/inspect.rst:850 msgid "" "A mutable mapping of parameters' names to arguments' values. Contains only " "explicitly bound arguments. Changes in :attr:`arguments` will reflect in :" "attr:`args` and :attr:`kwargs`." msgstr "" -#: ../../library/inspect.rst:853 +#: ../../library/inspect.rst:854 msgid "" "Should be used in conjunction with :attr:`Signature.parameters` for any " "argument processing purposes." msgstr "" -#: ../../library/inspect.rst:858 +#: ../../library/inspect.rst:859 msgid "" "Arguments for which :meth:`Signature.bind` or :meth:`Signature.bind_partial` " "relied on a default value are skipped. However, if needed, use :meth:" "`BoundArguments.apply_defaults` to add them." msgstr "" -#: ../../library/inspect.rst:863 +#: ../../library/inspect.rst:864 msgid "" ":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :" "class:`collections.OrderedDict`." msgstr "" -#: ../../library/inspect.rst:869 +#: ../../library/inspect.rst:870 msgid "" "A tuple of positional arguments values. Dynamically computed from the :attr:" "`arguments` attribute." msgstr "" -#: ../../library/inspect.rst:874 +#: ../../library/inspect.rst:875 msgid "" "A dict of keyword arguments values. Dynamically computed from the :attr:" "`arguments` attribute." msgstr "" -#: ../../library/inspect.rst:879 +#: ../../library/inspect.rst:880 msgid "A reference to the parent :class:`Signature` object." msgstr "" -#: ../../library/inspect.rst:883 +#: ../../library/inspect.rst:884 msgid "Set default values for missing arguments." msgstr "" -#: ../../library/inspect.rst:885 +#: ../../library/inspect.rst:886 msgid "" "For variable-positional arguments (``*args``) the default is an empty tuple." msgstr "" -#: ../../library/inspect.rst:888 +#: ../../library/inspect.rst:889 msgid "" "For variable-keyword arguments (``**kwargs``) the default is an empty dict." msgstr "" -#: ../../library/inspect.rst:901 +#: ../../library/inspect.rst:902 msgid "" "The :attr:`args` and :attr:`kwargs` properties can be used to invoke " "functions::" msgstr "" -#: ../../library/inspect.rst:914 +#: ../../library/inspect.rst:915 msgid ":pep:`362` - Function Signature Object." msgstr "" -#: ../../library/inspect.rst:915 +#: ../../library/inspect.rst:916 msgid "The detailed specification, implementation details and examples." msgstr "" -#: ../../library/inspect.rst:921 +#: ../../library/inspect.rst:922 msgid "Classes and functions" msgstr "" -#: ../../library/inspect.rst:925 +#: ../../library/inspect.rst:926 msgid "" "Arrange the given list of classes into a hierarchy of nested lists. Where a " "nested list appears, it contains classes derived from the class whose entry " @@ -1224,7 +1224,7 @@ msgid "" "will appear multiple times." msgstr "" -#: ../../library/inspect.rst:936 +#: ../../library/inspect.rst:937 msgid "" "Get the names and default values of a Python function's parameters. A :term:" "`named tuple` ``ArgSpec(args, varargs, keywords, defaults)`` is returned. " @@ -1235,33 +1235,33 @@ msgid "" "in *args*." msgstr "" -#: ../../library/inspect.rst:944 +#: ../../library/inspect.rst:945 msgid "" "Use :func:`getfullargspec` for an updated API that is usually a drop-in " "replacement, but also correctly handles function annotations and keyword-" "only parameters." msgstr "" -#: ../../library/inspect.rst:949 +#: ../../library/inspect.rst:950 msgid "" "Alternatively, use :func:`signature` and :ref:`Signature Object `, which provide a more structured introspection API for " "callables." msgstr "" -#: ../../library/inspect.rst:956 +#: ../../library/inspect.rst:957 msgid "" "Get the names and default values of a Python function's parameters. A :term:" "`named tuple` is returned:" msgstr "" -#: ../../library/inspect.rst:959 +#: ../../library/inspect.rst:960 msgid "" "``FullArgSpec(args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, " "annotations)``" msgstr "" -#: ../../library/inspect.rst:962 +#: ../../library/inspect.rst:963 msgid "" "*args* is a list of the positional parameter names. *varargs* is the name of " "the ``*`` parameter or ``None`` if arbitrary positional arguments are not " @@ -1276,7 +1276,7 @@ msgid "" "report the function return value annotation (if any)." msgstr "" -#: ../../library/inspect.rst:977 +#: ../../library/inspect.rst:978 msgid "" "Note that :func:`signature` and :ref:`Signature Object ` provide the recommended API for callable introspection, and support " @@ -1286,14 +1286,14 @@ msgid "" "``inspect`` module API." msgstr "" -#: ../../library/inspect.rst:984 +#: ../../library/inspect.rst:985 msgid "" "This function is now based on :func:`signature`, but still ignores " "``__wrapped__`` attributes and includes the already bound first parameter in " "the signature output for bound methods." msgstr "" -#: ../../library/inspect.rst:989 +#: ../../library/inspect.rst:990 msgid "" "This method was previously documented as deprecated in favour of :func:" "`signature` in Python 3.5, but that decision has been reversed in order to " @@ -1301,7 +1301,7 @@ msgid "" "code migrating away from the legacy :func:`getargspec` API." msgstr "" -#: ../../library/inspect.rst:1004 +#: ../../library/inspect.rst:1005 msgid "" "Get information about arguments passed into a particular frame. A :term:" "`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is returned. " @@ -1310,47 +1310,47 @@ msgid "" "dictionary of the given frame." msgstr "" -#: ../../library/inspect.rst:1011 ../../library/inspect.rst:1048 +#: ../../library/inspect.rst:1012 ../../library/inspect.rst:1049 msgid "This function was inadvertently marked as deprecated in Python 3.5." msgstr "" -#: ../../library/inspect.rst:1016 +#: ../../library/inspect.rst:1017 msgid "" "Format a pretty argument spec from the values returned by :func:" "`getfullargspec`." msgstr "" -#: ../../library/inspect.rst:1019 +#: ../../library/inspect.rst:1020 msgid "" "The first seven arguments are (``args``, ``varargs``, ``varkw``, " "``defaults``, ``kwonlyargs``, ``kwonlydefaults``, ``annotations``)." msgstr "" -#: ../../library/inspect.rst:1022 +#: ../../library/inspect.rst:1023 msgid "" "The other six arguments are functions that are called to turn argument " "names, ``*`` argument name, ``**`` argument name, default values, return " "annotation and individual annotations into strings, respectively." msgstr "" -#: ../../library/inspect.rst:1026 +#: ../../library/inspect.rst:1027 msgid "For example:" msgstr "" -#: ../../library/inspect.rst:1035 +#: ../../library/inspect.rst:1036 msgid "" "Use :func:`signature` and :ref:`Signature Object `, which provide a better introspecting API for callables." msgstr "" -#: ../../library/inspect.rst:1043 +#: ../../library/inspect.rst:1044 msgid "" "Format a pretty argument spec from the four values returned by :func:" "`getargvalues`. The format\\* arguments are the corresponding optional " "formatting functions that are called to turn names and values into strings." msgstr "" -#: ../../library/inspect.rst:1053 +#: ../../library/inspect.rst:1054 msgid "" "Return a tuple of class cls's base classes, including cls, in method " "resolution order. No class appears more than once in this tuple. Note that " @@ -1358,7 +1358,7 @@ msgid "" "user-defined metatype is in use, cls will be the first element of the tuple." msgstr "" -#: ../../library/inspect.rst:1061 +#: ../../library/inspect.rst:1062 msgid "" "Bind the *args* and *kwds* to the argument names of the Python function or " "method *func*, as if it was called with them. For bound methods, bind also " @@ -1371,11 +1371,11 @@ msgid "" "example::" msgstr "" -#: ../../library/inspect.rst:1084 +#: ../../library/inspect.rst:1085 msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead." msgstr "" -#: ../../library/inspect.rst:1090 +#: ../../library/inspect.rst:1091 msgid "" "Get the mapping of external name references in a Python function or method " "*func* to their current values. A :term:`named tuple` " @@ -1387,18 +1387,18 @@ msgid "" "builtins." msgstr "" -#: ../../library/inspect.rst:1099 +#: ../../library/inspect.rst:1100 msgid "" ":exc:`TypeError` is raised if *func* is not a Python function or method." msgstr "" -#: ../../library/inspect.rst:1106 +#: ../../library/inspect.rst:1107 msgid "" "Get the object wrapped by *func*. It follows the chain of :attr:" "`__wrapped__` attributes returning the last object in the chain." msgstr "" -#: ../../library/inspect.rst:1109 +#: ../../library/inspect.rst:1110 msgid "" "*stop* is an optional callback accepting an object in the wrapper chain as " "its sole argument that allows the unwrapping to be terminated early if the " @@ -1408,68 +1408,68 @@ msgid "" "``__signature__`` attribute defined." msgstr "" -#: ../../library/inspect.rst:1116 +#: ../../library/inspect.rst:1117 msgid ":exc:`ValueError` is raised if a cycle is encountered." msgstr "" -#: ../../library/inspect.rst:1123 +#: ../../library/inspect.rst:1124 msgid "Compute the annotations dict for an object." msgstr "" -#: ../../library/inspect.rst:1125 +#: ../../library/inspect.rst:1126 msgid "" "``obj`` may be a callable, class, or module. Passing in an object of any " "other type raises :exc:`TypeError`." msgstr "" -#: ../../library/inspect.rst:1128 +#: ../../library/inspect.rst:1129 msgid "" "Returns a dict. ``get_annotations()`` returns a new dict every time it's " "called; calling it twice on the same object will return two different but " "equivalent dicts." msgstr "" -#: ../../library/inspect.rst:1132 +#: ../../library/inspect.rst:1133 msgid "This function handles several details for you:" msgstr "" -#: ../../library/inspect.rst:1134 +#: ../../library/inspect.rst:1135 msgid "" "If ``eval_str`` is true, values of type ``str`` will be un-stringized using :" "func:`eval()`. This is intended for use with stringized annotations (``from " "__future__ import annotations``)." msgstr "" -#: ../../library/inspect.rst:1138 +#: ../../library/inspect.rst:1139 msgid "" "If ``obj`` doesn't have an annotations dict, returns an empty dict. " "(Functions and methods always have an annotations dict; classes, modules, " "and other types of callables may not.)" msgstr "" -#: ../../library/inspect.rst:1142 +#: ../../library/inspect.rst:1143 msgid "" "Ignores inherited annotations on classes. If a class doesn't have its own " "annotations dict, returns an empty dict." msgstr "" -#: ../../library/inspect.rst:1144 +#: ../../library/inspect.rst:1145 msgid "" "All accesses to object members and dict values are done using ``getattr()`` " "and ``dict.get()`` for safety." msgstr "" -#: ../../library/inspect.rst:1146 +#: ../../library/inspect.rst:1147 msgid "Always, always, always returns a freshly-created dict." msgstr "" -#: ../../library/inspect.rst:1148 +#: ../../library/inspect.rst:1149 msgid "" "``eval_str`` controls whether or not values of type ``str`` are replaced " "with the result of calling :func:`eval()` on those values:" msgstr "" -#: ../../library/inspect.rst:1151 +#: ../../library/inspect.rst:1152 msgid "" "If eval_str is true, :func:`eval()` is called on values of type ``str``. " "(Note that ``get_annotations`` doesn't catch exceptions; if :func:`eval()` " @@ -1477,12 +1477,12 @@ msgid "" "call.)" msgstr "" -#: ../../library/inspect.rst:1155 +#: ../../library/inspect.rst:1156 msgid "" "If eval_str is false (the default), values of type ``str`` are unchanged." msgstr "" -#: ../../library/inspect.rst:1157 +#: ../../library/inspect.rst:1158 msgid "" "``globals`` and ``locals`` are passed in to :func:`eval()`; see the " "documentation for :func:`eval()` for more information. If ``globals`` or " @@ -1490,35 +1490,35 @@ msgid "" "specific default, contingent on ``type(obj)``:" msgstr "" -#: ../../library/inspect.rst:1162 +#: ../../library/inspect.rst:1163 msgid "If ``obj`` is a module, ``globals`` defaults to ``obj.__dict__``." msgstr "" -#: ../../library/inspect.rst:1163 +#: ../../library/inspect.rst:1164 msgid "" "If ``obj`` is a class, ``globals`` defaults to ``sys.modules[obj.__module__]." "__dict__`` and ``locals`` defaults to the ``obj`` class namespace." msgstr "" -#: ../../library/inspect.rst:1166 +#: ../../library/inspect.rst:1167 msgid "" "If ``obj`` is a callable, ``globals`` defaults to ``obj.__globals__``, " "although if ``obj`` is a wrapped function (using ``functools." "update_wrapper()``) it is first unwrapped." msgstr "" -#: ../../library/inspect.rst:1170 +#: ../../library/inspect.rst:1171 msgid "" "Calling ``get_annotations`` is best practice for accessing the annotations " "dict of any object. See :ref:`annotations-howto` for more information on " "annotations best practices." msgstr "" -#: ../../library/inspect.rst:1180 +#: ../../library/inspect.rst:1181 msgid "The interpreter stack" msgstr "" -#: ../../library/inspect.rst:1182 +#: ../../library/inspect.rst:1183 msgid "" "When the following functions return \"frame records,\" each record is a :" "term:`named tuple` ``FrameInfo(frame, filename, lineno, function, " @@ -1528,11 +1528,11 @@ msgid "" "list." msgstr "" -#: ../../library/inspect.rst:1190 +#: ../../library/inspect.rst:1191 msgid "Return a named tuple instead of a tuple." msgstr "" -#: ../../library/inspect.rst:1195 +#: ../../library/inspect.rst:1196 msgid "" "Keeping references to frame objects, as found in the first element of the " "frame records these functions return, can cause your program to create " @@ -1544,7 +1544,7 @@ msgid "" "consumption which occurs." msgstr "" -#: ../../library/inspect.rst:1203 +#: ../../library/inspect.rst:1204 msgid "" "Though the cycle detector will catch these, destruction of the frames (and " "local variables) can be made deterministic by removing the cycle in a :" @@ -1552,27 +1552,27 @@ msgid "" "disabled when Python was compiled or using :func:`gc.disable`. For example::" msgstr "" -#: ../../library/inspect.rst:1215 +#: ../../library/inspect.rst:1216 msgid "" "If you want to keep the frame around (for example to print a traceback " "later), you can also break reference cycles by using the :meth:`frame.clear` " "method." msgstr "" -#: ../../library/inspect.rst:1219 +#: ../../library/inspect.rst:1220 msgid "" "The optional *context* argument supported by most of these functions " "specifies the number of lines of context to return, which are centered " "around the current line." msgstr "" -#: ../../library/inspect.rst:1226 +#: ../../library/inspect.rst:1227 msgid "" "Get information about a frame or traceback object. A :term:`named tuple` " "``Traceback(filename, lineno, function, code_context, index)`` is returned." msgstr "" -#: ../../library/inspect.rst:1232 +#: ../../library/inspect.rst:1233 msgid "" "Get a list of frame records for a frame and all outer frames. These frames " "represent the calls that lead to the creation of *frame*. The first entry in " @@ -1580,14 +1580,14 @@ msgid "" "outermost call on *frame*'s stack." msgstr "" -#: ../../library/inspect.rst:1237 ../../library/inspect.rst:1250 -#: ../../library/inspect.rst:1274 ../../library/inspect.rst:1287 +#: ../../library/inspect.rst:1238 ../../library/inspect.rst:1251 +#: ../../library/inspect.rst:1275 ../../library/inspect.rst:1288 msgid "" "A list of :term:`named tuples ` ``FrameInfo(frame, filename, " "lineno, function, code_context, index)`` is returned." msgstr "" -#: ../../library/inspect.rst:1245 +#: ../../library/inspect.rst:1246 msgid "" "Get a list of frame records for a traceback's frame and all inner frames. " "These frames represent calls made as a consequence of *frame*. The first " @@ -1595,11 +1595,11 @@ msgid "" "the exception was raised." msgstr "" -#: ../../library/inspect.rst:1258 +#: ../../library/inspect.rst:1259 msgid "Return the frame object for the caller's stack frame." msgstr "" -#: ../../library/inspect.rst:1262 +#: ../../library/inspect.rst:1263 msgid "" "This function relies on Python stack frame support in the interpreter, which " "isn't guaranteed to exist in all implementations of Python. If running in " @@ -1607,14 +1607,14 @@ msgid "" "``None``." msgstr "" -#: ../../library/inspect.rst:1270 +#: ../../library/inspect.rst:1271 msgid "" "Return a list of frame records for the caller's stack. The first entry in " "the returned list represents the caller; the last entry represents the " "outermost call on the stack." msgstr "" -#: ../../library/inspect.rst:1282 +#: ../../library/inspect.rst:1283 msgid "" "Return a list of frame records for the stack between the current frame and " "the frame in which an exception currently being handled was raised in. The " @@ -1622,11 +1622,11 @@ msgid "" "where the exception was raised." msgstr "" -#: ../../library/inspect.rst:1294 +#: ../../library/inspect.rst:1295 msgid "Fetching attributes statically" msgstr "" -#: ../../library/inspect.rst:1296 +#: ../../library/inspect.rst:1297 msgid "" "Both :func:`getattr` and :func:`hasattr` can trigger code execution when " "fetching or checking for the existence of attributes. Descriptors, like " @@ -1634,20 +1634,20 @@ msgid "" "`__getattribute__` may be called." msgstr "" -#: ../../library/inspect.rst:1301 +#: ../../library/inspect.rst:1302 msgid "" "For cases where you want passive introspection, like documentation tools, " "this can be inconvenient. :func:`getattr_static` has the same signature as :" "func:`getattr` but avoids executing code when it fetches attributes." msgstr "" -#: ../../library/inspect.rst:1307 +#: ../../library/inspect.rst:1308 msgid "" "Retrieve attributes without triggering dynamic lookup via the descriptor " "protocol, :meth:`__getattr__` or :meth:`__getattribute__`." msgstr "" -#: ../../library/inspect.rst:1310 +#: ../../library/inspect.rst:1311 msgid "" "Note: this function may not be able to retrieve all attributes that getattr " "can fetch (like dynamically created attributes) and may find attributes that " @@ -1655,31 +1655,31 @@ msgid "" "return descriptors objects instead of instance members." msgstr "" -#: ../../library/inspect.rst:1316 +#: ../../library/inspect.rst:1317 msgid "" "If the instance :attr:`~object.__dict__` is shadowed by another member (for " "example a property) then this function will be unable to find instance " "members." msgstr "" -#: ../../library/inspect.rst:1322 +#: ../../library/inspect.rst:1323 msgid "" ":func:`getattr_static` does not resolve descriptors, for example slot " "descriptors or getset descriptors on objects implemented in C. The " "descriptor object is returned instead of the underlying attribute." msgstr "" -#: ../../library/inspect.rst:1326 +#: ../../library/inspect.rst:1327 msgid "" "You can handle these with code like the following. Note that for arbitrary " "getset descriptors invoking these may trigger code execution::" msgstr "" -#: ../../library/inspect.rst:1352 +#: ../../library/inspect.rst:1353 msgid "Current State of Generators and Coroutines" msgstr "" -#: ../../library/inspect.rst:1354 +#: ../../library/inspect.rst:1355 msgid "" "When implementing coroutine schedulers and for other advanced uses of " "generators, it is useful to determine whether a generator is currently " @@ -1688,31 +1688,31 @@ msgid "" "generator to be determined easily." msgstr "" -#: ../../library/inspect.rst:1362 +#: ../../library/inspect.rst:1363 msgid "Get current state of a generator-iterator." msgstr "" -#: ../../library/inspect.rst:1368 ../../library/inspect.rst:1383 +#: ../../library/inspect.rst:1369 ../../library/inspect.rst:1384 msgid "Possible states are:" msgstr "" -#: ../../library/inspect.rst:1365 +#: ../../library/inspect.rst:1366 msgid "GEN_CREATED: Waiting to start execution." msgstr "" -#: ../../library/inspect.rst:1366 +#: ../../library/inspect.rst:1367 msgid "GEN_RUNNING: Currently being executed by the interpreter." msgstr "" -#: ../../library/inspect.rst:1367 +#: ../../library/inspect.rst:1368 msgid "GEN_SUSPENDED: Currently suspended at a yield expression." msgstr "" -#: ../../library/inspect.rst:1368 +#: ../../library/inspect.rst:1369 msgid "GEN_CLOSED: Execution has completed." msgstr "" -#: ../../library/inspect.rst:1374 +#: ../../library/inspect.rst:1375 msgid "" "Get current state of a coroutine object. The function is intended to be " "used with coroutine objects created by :keyword:`async def` functions, but " @@ -1720,30 +1720,30 @@ msgid "" "``cr_frame`` attributes." msgstr "" -#: ../../library/inspect.rst:1380 +#: ../../library/inspect.rst:1381 msgid "CORO_CREATED: Waiting to start execution." msgstr "" -#: ../../library/inspect.rst:1381 +#: ../../library/inspect.rst:1382 msgid "CORO_RUNNING: Currently being executed by the interpreter." msgstr "" -#: ../../library/inspect.rst:1382 +#: ../../library/inspect.rst:1383 msgid "CORO_SUSPENDED: Currently suspended at an await expression." msgstr "" -#: ../../library/inspect.rst:1383 +#: ../../library/inspect.rst:1384 msgid "CORO_CLOSED: Execution has completed." msgstr "" -#: ../../library/inspect.rst:1387 +#: ../../library/inspect.rst:1388 msgid "" "The current internal state of the generator can also be queried. This is " "mostly useful for testing purposes, to ensure that internal state is being " "updated as expected:" msgstr "" -#: ../../library/inspect.rst:1393 +#: ../../library/inspect.rst:1394 msgid "" "Get the mapping of live local variables in *generator* to their current " "values. A dictionary is returned that maps from variable names to values. " @@ -1751,14 +1751,14 @@ msgid "" "generator, and all the same caveats apply." msgstr "" -#: ../../library/inspect.rst:1398 +#: ../../library/inspect.rst:1399 msgid "" "If *generator* is a :term:`generator` with no currently associated frame, " "then an empty dictionary is returned. :exc:`TypeError` is raised if " "*generator* is not a Python generator object." msgstr "" -#: ../../library/inspect.rst:1404 +#: ../../library/inspect.rst:1405 msgid "" "This function relies on the generator exposing a Python stack frame for " "introspection, which isn't guaranteed to be the case in all implementations " @@ -1766,76 +1766,76 @@ msgid "" "dictionary." msgstr "" -#: ../../library/inspect.rst:1413 +#: ../../library/inspect.rst:1414 msgid "" "This function is analogous to :func:`~inspect.getgeneratorlocals`, but works " "for coroutine objects created by :keyword:`async def` functions." msgstr "" -#: ../../library/inspect.rst:1422 +#: ../../library/inspect.rst:1423 msgid "Code Objects Bit Flags" msgstr "" -#: ../../library/inspect.rst:1424 +#: ../../library/inspect.rst:1425 msgid "" "Python code objects have a ``co_flags`` attribute, which is a bitmap of the " "following flags:" msgstr "" -#: ../../library/inspect.rst:1429 +#: ../../library/inspect.rst:1430 msgid "The code object is optimized, using fast locals." msgstr "" -#: ../../library/inspect.rst:1433 +#: ../../library/inspect.rst:1434 msgid "" "If set, a new dict will be created for the frame's ``f_locals`` when the " "code object is executed." msgstr "" -#: ../../library/inspect.rst:1438 +#: ../../library/inspect.rst:1439 msgid "The code object has a variable positional parameter (``*args``-like)." msgstr "" -#: ../../library/inspect.rst:1442 +#: ../../library/inspect.rst:1443 msgid "The code object has a variable keyword parameter (``**kwargs``-like)." msgstr "" -#: ../../library/inspect.rst:1446 +#: ../../library/inspect.rst:1447 msgid "The flag is set when the code object is a nested function." msgstr "" -#: ../../library/inspect.rst:1450 +#: ../../library/inspect.rst:1451 msgid "" "The flag is set when the code object is a generator function, i.e. a " "generator object is returned when the code object is executed." msgstr "" -#: ../../library/inspect.rst:1455 +#: ../../library/inspect.rst:1456 msgid "The flag is set if there are no free or cell variables." msgstr "" -#: ../../library/inspect.rst:1459 +#: ../../library/inspect.rst:1460 msgid "" "The flag is set when the code object is a coroutine function. When the code " "object is executed it returns a coroutine object. See :pep:`492` for more " "details." msgstr "" -#: ../../library/inspect.rst:1467 +#: ../../library/inspect.rst:1468 msgid "" "The flag is used to transform generators into generator-based coroutines. " "Generator objects with this flag can be used in ``await`` expression, and " "can ``yield from`` coroutine objects. See :pep:`492` for more details." msgstr "" -#: ../../library/inspect.rst:1476 +#: ../../library/inspect.rst:1477 msgid "" "The flag is set when the code object is an asynchronous generator function. " "When the code object is executed it returns an asynchronous generator " "object. See :pep:`525` for more details." msgstr "" -#: ../../library/inspect.rst:1483 +#: ../../library/inspect.rst:1484 msgid "" "The flags are specific to CPython, and may not be defined in other Python " "implementations. Furthermore, the flags are an implementation detail, and " @@ -1843,24 +1843,24 @@ msgid "" "use public APIs from the :mod:`inspect` module for any introspection needs." msgstr "" -#: ../../library/inspect.rst:1493 +#: ../../library/inspect.rst:1494 msgid "Command Line Interface" msgstr "" -#: ../../library/inspect.rst:1495 +#: ../../library/inspect.rst:1496 msgid "" "The :mod:`inspect` module also provides a basic introspection capability " "from the command line." msgstr "" -#: ../../library/inspect.rst:1500 +#: ../../library/inspect.rst:1501 msgid "" "By default, accepts the name of a module and prints the source of that " "module. A class or function within the module can be printed instead by " "appended a colon and the qualified name of the target object." msgstr "" -#: ../../library/inspect.rst:1506 +#: ../../library/inspect.rst:1507 msgid "" "Print information about the specified object rather than the source code" msgstr "" From 2816fcbce859cc3e869b8afa40c8ef7cacfb1c86 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Fri, 4 Mar 2022 00:16:16 +0000 Subject: [PATCH 3/3] sync with cpython 7b5b429a --- library/codecs.po | 796 +++++++++++++++++++++++----------------------- library/sys.po | 682 +++++++++++++++++++-------------------- 2 files changed, 739 insertions(+), 739 deletions(-) diff --git a/library/codecs.po b/library/codecs.po index 8eae9435b0..374b76724e 100644 --- a/library/codecs.po +++ b/library/codecs.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-10-26 16:47+0000\n" +"POT-Creation-Date: 2022-03-04 00:14+0000\n" "PO-Revision-Date: 2018-05-23 14:40+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -360,8 +360,8 @@ msgid "Value" msgstr "" #: ../../library/codecs.rst:308 ../../library/codecs.rst:331 -#: ../../library/codecs.rst:364 ../../library/codecs.rst:1276 -#: ../../library/codecs.rst:1343 ../../library/codecs.rst:1398 +#: ../../library/codecs.rst:364 ../../library/codecs.rst:1277 +#: ../../library/codecs.rst:1344 ../../library/codecs.rst:1399 msgid "Meaning" msgstr "" @@ -870,64 +870,64 @@ msgstr "" #: ../../library/codecs.rst:697 msgid "" -"Writes the concatenated list of strings to the stream (possibly by reusing " -"the :meth:`write` method). The standard bytes-to-bytes codecs do not support " -"this method." +"Writes the concatenated iterable of strings to the stream (possibly by " +"reusing the :meth:`write` method). Infinite or very large iterables are not " +"supported. The standard bytes-to-bytes codecs do not support this method." msgstr "" -#: ../../library/codecs.rst:704 ../../library/codecs.rst:799 +#: ../../library/codecs.rst:705 ../../library/codecs.rst:800 msgid "Resets the codec buffers used for keeping internal state." msgstr "" -#: ../../library/codecs.rst:706 +#: ../../library/codecs.rst:707 msgid "" "Calling this method should ensure that the data on the output is put into a " "clean state that allows appending of new fresh data without having to rescan " "the whole stream to recover state." msgstr "" -#: ../../library/codecs.rst:711 +#: ../../library/codecs.rst:712 msgid "" "In addition to the above methods, the :class:`StreamWriter` must also " "inherit all other methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:718 +#: ../../library/codecs.rst:719 msgid "StreamReader Objects" msgstr "StreamReader 物件" -#: ../../library/codecs.rst:720 +#: ../../library/codecs.rst:721 msgid "" "The :class:`StreamReader` class is a subclass of :class:`Codec` and defines " "the following methods which every stream reader must define in order to be " "compatible with the Python codec registry." msgstr "" -#: ../../library/codecs.rst:727 +#: ../../library/codecs.rst:728 msgid "Constructor for a :class:`StreamReader` instance." msgstr "" -#: ../../library/codecs.rst:729 +#: ../../library/codecs.rst:730 msgid "" "All stream readers must provide this constructor interface. They are free to " "add additional keyword arguments, but only the ones defined here are used by " "the Python codec registry." msgstr "" -#: ../../library/codecs.rst:733 +#: ../../library/codecs.rst:734 msgid "" "The *stream* argument must be a file-like object open for reading text or " "binary data, as appropriate for the specific codec." msgstr "" -#: ../../library/codecs.rst:736 +#: ../../library/codecs.rst:737 msgid "" "The :class:`StreamReader` may implement different error handling schemes by " "providing the *errors* keyword argument. See :ref:`error-handlers` for the " "standard error handlers the underlying stream codec may support." msgstr "" -#: ../../library/codecs.rst:740 +#: ../../library/codecs.rst:741 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -935,24 +935,24 @@ msgid "" "object." msgstr "" -#: ../../library/codecs.rst:744 +#: ../../library/codecs.rst:745 msgid "" "The set of allowed values for the *errors* argument can be extended with :" "func:`register_error`." msgstr "" -#: ../../library/codecs.rst:750 +#: ../../library/codecs.rst:751 msgid "Decodes data from the stream and returns the resulting object." msgstr "" -#: ../../library/codecs.rst:752 +#: ../../library/codecs.rst:753 msgid "" "The *chars* argument indicates the number of decoded code points or bytes to " "return. The :func:`read` method will never return more data than requested, " "but it might return less, if there is not enough available." msgstr "" -#: ../../library/codecs.rst:757 +#: ../../library/codecs.rst:758 msgid "" "The *size* argument indicates the approximate maximum number of encoded " "bytes or code points to read for decoding. The decoder can modify this " @@ -961,13 +961,13 @@ msgid "" "huge files in one step." msgstr "" -#: ../../library/codecs.rst:764 +#: ../../library/codecs.rst:765 msgid "" "The *firstline* flag indicates that it would be sufficient to only return " "the first line, if there are decoding errors on later lines." msgstr "" -#: ../../library/codecs.rst:768 +#: ../../library/codecs.rst:769 msgid "" "The method should use a greedy read strategy meaning that it should read as " "much data as is allowed within the definition of the encoding and the given " @@ -975,68 +975,68 @@ msgid "" "the stream, these should be read too." msgstr "" -#: ../../library/codecs.rst:776 +#: ../../library/codecs.rst:777 msgid "Read one line from the input stream and return the decoded data." msgstr "" -#: ../../library/codecs.rst:778 +#: ../../library/codecs.rst:779 msgid "" "*size*, if given, is passed as size argument to the stream's :meth:`read` " "method." msgstr "" -#: ../../library/codecs.rst:781 +#: ../../library/codecs.rst:782 msgid "" "If *keepends* is false line-endings will be stripped from the lines returned." msgstr "" -#: ../../library/codecs.rst:787 +#: ../../library/codecs.rst:788 msgid "" "Read all lines available on the input stream and return them as a list of " "lines." msgstr "" -#: ../../library/codecs.rst:790 +#: ../../library/codecs.rst:791 msgid "" "Line-endings are implemented using the codec's :meth:`decode` method and are " "included in the list entries if *keepends* is true." msgstr "" -#: ../../library/codecs.rst:793 +#: ../../library/codecs.rst:794 msgid "" "*sizehint*, if given, is passed as the *size* argument to the stream's :meth:" "`read` method." msgstr "" -#: ../../library/codecs.rst:801 +#: ../../library/codecs.rst:802 msgid "" "Note that no stream repositioning should take place. This method is " "primarily intended to be able to recover from decoding errors." msgstr "" -#: ../../library/codecs.rst:805 +#: ../../library/codecs.rst:806 msgid "" "In addition to the above methods, the :class:`StreamReader` must also " "inherit all other methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:811 +#: ../../library/codecs.rst:812 msgid "StreamReaderWriter Objects" msgstr "StreamReaderWriter 物件" -#: ../../library/codecs.rst:813 +#: ../../library/codecs.rst:814 msgid "" "The :class:`StreamReaderWriter` is a convenience class that allows wrapping " "streams which work in both read and write modes." msgstr "" -#: ../../library/codecs.rst:816 ../../library/codecs.rst:840 +#: ../../library/codecs.rst:817 ../../library/codecs.rst:841 msgid "" "The design is such that one can use the factory functions returned by the :" "func:`lookup` function to construct the instance." msgstr "" -#: ../../library/codecs.rst:822 +#: ../../library/codecs.rst:823 msgid "" "Creates a :class:`StreamReaderWriter` instance. *stream* must be a file-like " "object. *Reader* and *Writer* must be factory functions or classes providing " @@ -1045,24 +1045,24 @@ msgid "" "writers." msgstr "" -#: ../../library/codecs.rst:827 +#: ../../library/codecs.rst:828 msgid "" ":class:`StreamReaderWriter` instances define the combined interfaces of :" "class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " "other methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:835 +#: ../../library/codecs.rst:836 msgid "StreamRecoder Objects" msgstr "StreamRecoder 物件" -#: ../../library/codecs.rst:837 +#: ../../library/codecs.rst:838 msgid "" "The :class:`StreamRecoder` translates data from one encoding to another, " "which is sometimes useful when dealing with different encoding environments." msgstr "" -#: ../../library/codecs.rst:846 +#: ../../library/codecs.rst:847 msgid "" "Creates a :class:`StreamRecoder` instance which implements a two-way " "conversion: *encode* and *decode* work on the frontend — the data visible to " @@ -1070,17 +1070,17 @@ msgid "" "work on the backend — the data in *stream*." msgstr "" -#: ../../library/codecs.rst:851 +#: ../../library/codecs.rst:852 msgid "" "You can use these objects to do transparent transcodings, e.g., from Latin-1 " "to UTF-8 and back." msgstr "" -#: ../../library/codecs.rst:854 +#: ../../library/codecs.rst:855 msgid "The *stream* argument must be a file-like object." msgstr "" -#: ../../library/codecs.rst:856 +#: ../../library/codecs.rst:857 msgid "" "The *encode* and *decode* arguments must adhere to the :class:`Codec` " "interface. *Reader* and *Writer* must be factory functions or classes " @@ -1088,24 +1088,24 @@ msgid "" "interface respectively." msgstr "" -#: ../../library/codecs.rst:861 +#: ../../library/codecs.rst:862 msgid "" "Error handling is done in the same way as defined for the stream readers and " "writers." msgstr "" -#: ../../library/codecs.rst:865 +#: ../../library/codecs.rst:866 msgid "" ":class:`StreamRecoder` instances define the combined interfaces of :class:" "`StreamReader` and :class:`StreamWriter` classes. They inherit all other " "methods and attributes from the underlying stream." msgstr "" -#: ../../library/codecs.rst:873 +#: ../../library/codecs.rst:874 msgid "Encodings and Unicode" msgstr "" -#: ../../library/codecs.rst:875 +#: ../../library/codecs.rst:876 msgid "" "Strings are stored internally as sequences of code points in range ``0x0``--" "``0x10FFFF``. (See :pep:`393` for more details about the implementation.) " @@ -1117,7 +1117,7 @@ msgid "" "collectivity referred to as :term:`text encodings `." msgstr "" -#: ../../library/codecs.rst:885 +#: ../../library/codecs.rst:886 msgid "" "The simplest text encoding (called ``'latin-1'`` or ``'iso-8859-1'``) maps " "the code points 0--255 to the bytes ``0x0``--``0xff``, which means that a " @@ -1128,7 +1128,7 @@ msgid "" "position 3: ordinal not in range(256)``." msgstr "" -#: ../../library/codecs.rst:893 +#: ../../library/codecs.rst:894 msgid "" "There's another group of encodings (the so called charmap encodings) that " "choose a different subset of all Unicode code points and how these code " @@ -1138,7 +1138,7 @@ msgid "" "that shows you which character is mapped to which byte value." msgstr "" -#: ../../library/codecs.rst:900 +#: ../../library/codecs.rst:901 msgid "" "All of these encodings can only encode 256 of the 1114112 code points " "defined in Unicode. A simple and straightforward way that can store each " @@ -1168,7 +1168,7 @@ msgid "" "normal character that will be decoded like any other." msgstr "" -#: ../../library/codecs.rst:926 +#: ../../library/codecs.rst:927 msgid "" "There's another encoding that is able to encode the full range of Unicode " "characters: UTF-8. UTF-8 is an 8-bit encoding, which means there are no " @@ -1179,59 +1179,59 @@ msgid "" "which when concatenated give the Unicode character):" msgstr "" -#: ../../library/codecs.rst:935 +#: ../../library/codecs.rst:936 msgid "Range" msgstr "" -#: ../../library/codecs.rst:935 +#: ../../library/codecs.rst:936 msgid "Encoding" msgstr "" -#: ../../library/codecs.rst:937 +#: ../../library/codecs.rst:938 msgid "``U-00000000`` ... ``U-0000007F``" msgstr "``U-00000000`` ... ``U-0000007F``" -#: ../../library/codecs.rst:937 +#: ../../library/codecs.rst:938 msgid "0xxxxxxx" msgstr "0xxxxxxx" -#: ../../library/codecs.rst:939 +#: ../../library/codecs.rst:940 msgid "``U-00000080`` ... ``U-000007FF``" msgstr "``U-00000080`` ... ``U-000007FF``" -#: ../../library/codecs.rst:939 +#: ../../library/codecs.rst:940 msgid "110xxxxx 10xxxxxx" msgstr "110xxxxx 10xxxxxx" -#: ../../library/codecs.rst:941 +#: ../../library/codecs.rst:942 msgid "``U-00000800`` ... ``U-0000FFFF``" msgstr "``U-00000800`` ... ``U-0000FFFF``" -#: ../../library/codecs.rst:941 +#: ../../library/codecs.rst:942 msgid "1110xxxx 10xxxxxx 10xxxxxx" msgstr "1110xxxx 10xxxxxx 10xxxxxx" -#: ../../library/codecs.rst:943 +#: ../../library/codecs.rst:944 msgid "``U-00010000`` ... ``U-0010FFFF``" msgstr "``U-00010000`` ... ``U-0010FFFF``" -#: ../../library/codecs.rst:943 +#: ../../library/codecs.rst:944 msgid "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" msgstr "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" -#: ../../library/codecs.rst:946 +#: ../../library/codecs.rst:947 msgid "" "The least significant bit of the Unicode character is the rightmost x bit." msgstr "" -#: ../../library/codecs.rst:948 +#: ../../library/codecs.rst:949 msgid "" "As UTF-8 is an 8-bit encoding no BOM is required and any ``U+FEFF`` " "character in the decoded string (even if it's the first character) is " "treated as a ``ZERO WIDTH NO-BREAK SPACE``." msgstr "" -#: ../../library/codecs.rst:952 +#: ../../library/codecs.rst:953 msgid "" "Without external information it's impossible to reliably determine which " "encoding was used for encoding a string. Each charmap encoding can decode " @@ -1258,7 +1258,7 @@ msgstr "" msgid "INVERTED QUESTION MARK" msgstr "" -#: ../../library/codecs.rst:968 +#: ../../library/codecs.rst:969 msgid "" "in iso-8859-1), this increases the probability that a ``utf-8-sig`` encoding " "can be correctly guessed from the byte sequence. So here the BOM is not used " @@ -1270,11 +1270,11 @@ msgid "" "the use of the BOM is discouraged and should generally be avoided." msgstr "" -#: ../../library/codecs.rst:981 +#: ../../library/codecs.rst:982 msgid "Standard Encodings" msgstr "" -#: ../../library/codecs.rst:983 +#: ../../library/codecs.rst:984 msgid "" "Python comes with a number of codecs built-in, either implemented as C " "functions or with dictionaries as mapping tables. The following table lists " @@ -1286,7 +1286,7 @@ msgid "" "alias for the ``'utf_8'`` codec." msgstr "" -#: ../../library/codecs.rst:993 +#: ../../library/codecs.rst:994 msgid "" "Some common encodings can bypass the codecs lookup machinery to improve " "performance. These optimization opportunities are only recognized by CPython " @@ -1296,11 +1296,11 @@ msgid "" "Using alternative aliases for these encodings may result in slower execution." msgstr "" -#: ../../library/codecs.rst:1001 +#: ../../library/codecs.rst:1002 msgid "Optimization opportunity recognized for us-ascii." msgstr "" -#: ../../library/codecs.rst:1004 +#: ../../library/codecs.rst:1005 msgid "" "Many of the character sets support the same languages. They vary in " "individual characters (e.g. whether the EURO SIGN is supported or not), and " @@ -1308,504 +1308,504 @@ msgid "" "languages in particular, the following variants typically exist:" msgstr "" -#: ../../library/codecs.rst:1009 +#: ../../library/codecs.rst:1010 msgid "an ISO 8859 codeset" msgstr "" -#: ../../library/codecs.rst:1011 +#: ../../library/codecs.rst:1012 msgid "" "a Microsoft Windows code page, which is typically derived from an 8859 " "codeset, but replaces control characters with additional graphic characters" msgstr "" -#: ../../library/codecs.rst:1014 +#: ../../library/codecs.rst:1015 msgid "an IBM EBCDIC code page" msgstr "" -#: ../../library/codecs.rst:1016 +#: ../../library/codecs.rst:1017 msgid "an IBM PC code page, which is ASCII compatible" msgstr "" -#: ../../library/codecs.rst:1021 ../../library/codecs.rst:1276 -#: ../../library/codecs.rst:1343 ../../library/codecs.rst:1398 +#: ../../library/codecs.rst:1022 ../../library/codecs.rst:1277 +#: ../../library/codecs.rst:1344 ../../library/codecs.rst:1399 msgid "Codec" msgstr "" -#: ../../library/codecs.rst:1021 ../../library/codecs.rst:1276 -#: ../../library/codecs.rst:1343 ../../library/codecs.rst:1398 +#: ../../library/codecs.rst:1022 ../../library/codecs.rst:1277 +#: ../../library/codecs.rst:1344 ../../library/codecs.rst:1399 msgid "Aliases" msgstr "" -#: ../../library/codecs.rst:1021 +#: ../../library/codecs.rst:1022 msgid "Languages" msgstr "語言" -#: ../../library/codecs.rst:1023 +#: ../../library/codecs.rst:1024 msgid "ascii" msgstr "ascii" -#: ../../library/codecs.rst:1023 +#: ../../library/codecs.rst:1024 msgid "646, us-ascii" msgstr "646, us-ascii" -#: ../../library/codecs.rst:1023 ../../library/codecs.rst:1029 -#: ../../library/codecs.rst:1037 +#: ../../library/codecs.rst:1024 ../../library/codecs.rst:1030 +#: ../../library/codecs.rst:1038 msgid "English" msgstr "英文" -#: ../../library/codecs.rst:1025 +#: ../../library/codecs.rst:1026 msgid "big5" msgstr "big5" -#: ../../library/codecs.rst:1025 +#: ../../library/codecs.rst:1026 msgid "big5-tw, csbig5" msgstr "big5-tw, csbig5" -#: ../../library/codecs.rst:1025 ../../library/codecs.rst:1027 -#: ../../library/codecs.rst:1085 +#: ../../library/codecs.rst:1026 ../../library/codecs.rst:1028 +#: ../../library/codecs.rst:1086 msgid "Traditional Chinese" msgstr "繁體中文" -#: ../../library/codecs.rst:1027 +#: ../../library/codecs.rst:1028 msgid "big5hkscs" msgstr "big5hkscs" -#: ../../library/codecs.rst:1027 +#: ../../library/codecs.rst:1028 msgid "big5-hkscs, hkscs" msgstr "big5-hkscs, hkscs" -#: ../../library/codecs.rst:1029 +#: ../../library/codecs.rst:1030 msgid "cp037" msgstr "cp037" -#: ../../library/codecs.rst:1029 +#: ../../library/codecs.rst:1030 msgid "IBM037, IBM039" msgstr "IBM037, IBM039" -#: ../../library/codecs.rst:1031 +#: ../../library/codecs.rst:1032 msgid "cp273" msgstr "cp273" -#: ../../library/codecs.rst:1031 +#: ../../library/codecs.rst:1032 msgid "273, IBM273, csIBM273" msgstr "273, IBM273, csIBM273" -#: ../../library/codecs.rst:1031 +#: ../../library/codecs.rst:1032 msgid "German" msgstr "德文" -#: ../../library/codecs.rst:1035 +#: ../../library/codecs.rst:1036 msgid "cp424" msgstr "cp424" -#: ../../library/codecs.rst:1035 +#: ../../library/codecs.rst:1036 msgid "EBCDIC-CP-HE, IBM424" msgstr "EBCDIC-CP-HE, IBM424" -#: ../../library/codecs.rst:1035 ../../library/codecs.rst:1055 -#: ../../library/codecs.rst:1065 ../../library/codecs.rst:1108 -#: ../../library/codecs.rst:1171 +#: ../../library/codecs.rst:1036 ../../library/codecs.rst:1056 +#: ../../library/codecs.rst:1066 ../../library/codecs.rst:1109 +#: ../../library/codecs.rst:1172 msgid "Hebrew" msgstr "希伯來文" -#: ../../library/codecs.rst:1037 +#: ../../library/codecs.rst:1038 msgid "cp437" msgstr "cp437" -#: ../../library/codecs.rst:1037 +#: ../../library/codecs.rst:1038 msgid "437, IBM437" msgstr "437, IBM437" -#: ../../library/codecs.rst:1039 +#: ../../library/codecs.rst:1040 msgid "cp500" msgstr "cp500" -#: ../../library/codecs.rst:1039 +#: ../../library/codecs.rst:1040 msgid "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" msgstr "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" -#: ../../library/codecs.rst:1039 ../../library/codecs.rst:1048 -#: ../../library/codecs.rst:1059 ../../library/codecs.rst:1095 -#: ../../library/codecs.rst:1102 ../../library/codecs.rst:1155 -#: ../../library/codecs.rst:1183 ../../library/codecs.rst:1211 +#: ../../library/codecs.rst:1040 ../../library/codecs.rst:1049 +#: ../../library/codecs.rst:1060 ../../library/codecs.rst:1096 +#: ../../library/codecs.rst:1103 ../../library/codecs.rst:1156 +#: ../../library/codecs.rst:1184 ../../library/codecs.rst:1212 msgid "Western Europe" msgstr "" -#: ../../library/codecs.rst:1042 +#: ../../library/codecs.rst:1043 msgid "cp720" msgstr "cp720" -#: ../../library/codecs.rst:1042 ../../library/codecs.rst:1069 -#: ../../library/codecs.rst:1110 ../../library/codecs.rst:1167 +#: ../../library/codecs.rst:1043 ../../library/codecs.rst:1070 +#: ../../library/codecs.rst:1111 ../../library/codecs.rst:1168 msgid "Arabic" msgstr "阿拉伯文" -#: ../../library/codecs.rst:1044 +#: ../../library/codecs.rst:1045 msgid "cp737" msgstr "cp737" -#: ../../library/codecs.rst:1044 ../../library/codecs.rst:1075 -#: ../../library/codecs.rst:1079 ../../library/codecs.rst:1104 -#: ../../library/codecs.rst:1169 ../../library/codecs.rst:1204 +#: ../../library/codecs.rst:1045 ../../library/codecs.rst:1076 +#: ../../library/codecs.rst:1080 ../../library/codecs.rst:1105 +#: ../../library/codecs.rst:1170 ../../library/codecs.rst:1205 msgid "Greek" msgstr "希臘文" -#: ../../library/codecs.rst:1046 +#: ../../library/codecs.rst:1047 msgid "cp775" msgstr "cp775" -#: ../../library/codecs.rst:1046 +#: ../../library/codecs.rst:1047 msgid "IBM775" msgstr "IBM775" -#: ../../library/codecs.rst:1046 ../../library/codecs.rst:1112 -#: ../../library/codecs.rst:1162 ../../library/codecs.rst:1179 +#: ../../library/codecs.rst:1047 ../../library/codecs.rst:1113 +#: ../../library/codecs.rst:1163 ../../library/codecs.rst:1180 msgid "Baltic languages" msgstr "" -#: ../../library/codecs.rst:1048 +#: ../../library/codecs.rst:1049 msgid "cp850" msgstr "cp850" -#: ../../library/codecs.rst:1048 +#: ../../library/codecs.rst:1049 msgid "850, IBM850" msgstr "850, IBM850" -#: ../../library/codecs.rst:1050 +#: ../../library/codecs.rst:1051 msgid "cp852" msgstr "cp852" -#: ../../library/codecs.rst:1050 +#: ../../library/codecs.rst:1051 msgid "852, IBM852" msgstr "852, IBM852" -#: ../../library/codecs.rst:1050 ../../library/codecs.rst:1097 -#: ../../library/codecs.rst:1158 ../../library/codecs.rst:1208 +#: ../../library/codecs.rst:1051 ../../library/codecs.rst:1098 +#: ../../library/codecs.rst:1159 ../../library/codecs.rst:1209 msgid "Central and Eastern Europe" msgstr "" -#: ../../library/codecs.rst:1052 +#: ../../library/codecs.rst:1053 msgid "cp855" msgstr "cp855" -#: ../../library/codecs.rst:1052 +#: ../../library/codecs.rst:1053 msgid "855, IBM855" msgstr "855, IBM855" -#: ../../library/codecs.rst:1052 ../../library/codecs.rst:1099 -#: ../../library/codecs.rst:1164 ../../library/codecs.rst:1201 +#: ../../library/codecs.rst:1053 ../../library/codecs.rst:1100 +#: ../../library/codecs.rst:1165 ../../library/codecs.rst:1202 msgid "Bulgarian, Byelorussian, Macedonian, Russian, Serbian" msgstr "" -#: ../../library/codecs.rst:1055 +#: ../../library/codecs.rst:1056 msgid "cp856" msgstr "cp856" -#: ../../library/codecs.rst:1057 +#: ../../library/codecs.rst:1058 msgid "cp857" msgstr "cp857" -#: ../../library/codecs.rst:1057 +#: ../../library/codecs.rst:1058 msgid "857, IBM857" msgstr "857, IBM857" -#: ../../library/codecs.rst:1057 ../../library/codecs.rst:1089 -#: ../../library/codecs.rst:1106 ../../library/codecs.rst:1173 -#: ../../library/codecs.rst:1213 +#: ../../library/codecs.rst:1058 ../../library/codecs.rst:1090 +#: ../../library/codecs.rst:1107 ../../library/codecs.rst:1174 +#: ../../library/codecs.rst:1214 msgid "Turkish" msgstr "土耳其文" -#: ../../library/codecs.rst:1059 +#: ../../library/codecs.rst:1060 msgid "cp858" msgstr "cp858" -#: ../../library/codecs.rst:1059 +#: ../../library/codecs.rst:1060 msgid "858, IBM858" msgstr "858, IBM858" -#: ../../library/codecs.rst:1061 +#: ../../library/codecs.rst:1062 msgid "cp860" msgstr "cp860" -#: ../../library/codecs.rst:1061 +#: ../../library/codecs.rst:1062 msgid "860, IBM860" msgstr "860, IBM860" -#: ../../library/codecs.rst:1061 +#: ../../library/codecs.rst:1062 msgid "Portuguese" msgstr "" -#: ../../library/codecs.rst:1063 +#: ../../library/codecs.rst:1064 msgid "cp861" msgstr "cp861" -#: ../../library/codecs.rst:1063 +#: ../../library/codecs.rst:1064 msgid "861, CP-IS, IBM861" msgstr "861, CP-IS, IBM861" -#: ../../library/codecs.rst:1063 ../../library/codecs.rst:1206 +#: ../../library/codecs.rst:1064 ../../library/codecs.rst:1207 msgid "Icelandic" msgstr "" -#: ../../library/codecs.rst:1065 +#: ../../library/codecs.rst:1066 msgid "cp862" msgstr "cp862" -#: ../../library/codecs.rst:1065 +#: ../../library/codecs.rst:1066 msgid "862, IBM862" msgstr "862, IBM862" -#: ../../library/codecs.rst:1067 +#: ../../library/codecs.rst:1068 msgid "cp863" msgstr "cp863" -#: ../../library/codecs.rst:1067 +#: ../../library/codecs.rst:1068 msgid "863, IBM863" msgstr "863, IBM863" -#: ../../library/codecs.rst:1067 +#: ../../library/codecs.rst:1068 msgid "Canadian" msgstr "" -#: ../../library/codecs.rst:1069 +#: ../../library/codecs.rst:1070 msgid "cp864" msgstr "cp864" -#: ../../library/codecs.rst:1069 +#: ../../library/codecs.rst:1070 msgid "IBM864" msgstr "IBM864" -#: ../../library/codecs.rst:1071 +#: ../../library/codecs.rst:1072 msgid "cp865" msgstr "cp865" -#: ../../library/codecs.rst:1071 +#: ../../library/codecs.rst:1072 msgid "865, IBM865" msgstr "865, IBM865" -#: ../../library/codecs.rst:1071 +#: ../../library/codecs.rst:1072 msgid "Danish, Norwegian" msgstr "" -#: ../../library/codecs.rst:1073 +#: ../../library/codecs.rst:1074 msgid "cp866" msgstr "cp866" -#: ../../library/codecs.rst:1073 +#: ../../library/codecs.rst:1074 msgid "866, IBM866" msgstr "866, IBM866" -#: ../../library/codecs.rst:1073 ../../library/codecs.rst:1189 +#: ../../library/codecs.rst:1074 ../../library/codecs.rst:1190 msgid "Russian" msgstr "俄羅斯文" -#: ../../library/codecs.rst:1075 +#: ../../library/codecs.rst:1076 msgid "cp869" msgstr "cp869" -#: ../../library/codecs.rst:1075 +#: ../../library/codecs.rst:1076 msgid "869, CP-GR, IBM869" msgstr "869, CP-GR, IBM869" -#: ../../library/codecs.rst:1077 +#: ../../library/codecs.rst:1078 msgid "cp874" msgstr "cp874" -#: ../../library/codecs.rst:1077 +#: ../../library/codecs.rst:1078 msgid "Thai" msgstr "泰文" -#: ../../library/codecs.rst:1079 +#: ../../library/codecs.rst:1080 msgid "cp875" msgstr "cp875" -#: ../../library/codecs.rst:1081 +#: ../../library/codecs.rst:1082 msgid "cp932" msgstr "cp932" -#: ../../library/codecs.rst:1081 +#: ../../library/codecs.rst:1082 msgid "932, ms932, mskanji, ms-kanji" msgstr "932, ms932, mskanji, ms-kanji" -#: ../../library/codecs.rst:1081 ../../library/codecs.rst:1116 -#: ../../library/codecs.rst:1118 ../../library/codecs.rst:1120 -#: ../../library/codecs.rst:1137 ../../library/codecs.rst:1140 -#: ../../library/codecs.rst:1145 ../../library/codecs.rst:1148 -#: ../../library/codecs.rst:1150 ../../library/codecs.rst:1218 -#: ../../library/codecs.rst:1221 ../../library/codecs.rst:1224 +#: ../../library/codecs.rst:1082 ../../library/codecs.rst:1117 +#: ../../library/codecs.rst:1119 ../../library/codecs.rst:1121 +#: ../../library/codecs.rst:1138 ../../library/codecs.rst:1141 +#: ../../library/codecs.rst:1146 ../../library/codecs.rst:1149 +#: ../../library/codecs.rst:1151 ../../library/codecs.rst:1219 +#: ../../library/codecs.rst:1222 ../../library/codecs.rst:1225 msgid "Japanese" msgstr "日文" -#: ../../library/codecs.rst:1083 +#: ../../library/codecs.rst:1084 msgid "cp949" msgstr "cp949" -#: ../../library/codecs.rst:1083 +#: ../../library/codecs.rst:1084 msgid "949, ms949, uhc" msgstr "949, ms949, uhc" -#: ../../library/codecs.rst:1083 ../../library/codecs.rst:1122 -#: ../../library/codecs.rst:1152 ../../library/codecs.rst:1187 +#: ../../library/codecs.rst:1084 ../../library/codecs.rst:1123 +#: ../../library/codecs.rst:1153 ../../library/codecs.rst:1188 msgid "Korean" msgstr "韓文" -#: ../../library/codecs.rst:1085 +#: ../../library/codecs.rst:1086 msgid "cp950" msgstr "cp950" -#: ../../library/codecs.rst:1085 +#: ../../library/codecs.rst:1086 msgid "950, ms950" msgstr "950, ms950" -#: ../../library/codecs.rst:1087 +#: ../../library/codecs.rst:1088 msgid "cp1006" msgstr "cp1006" -#: ../../library/codecs.rst:1087 +#: ../../library/codecs.rst:1088 msgid "Urdu" msgstr "" -#: ../../library/codecs.rst:1089 +#: ../../library/codecs.rst:1090 msgid "cp1026" msgstr "cp1026" -#: ../../library/codecs.rst:1089 +#: ../../library/codecs.rst:1090 msgid "ibm1026" msgstr "ibm1026" -#: ../../library/codecs.rst:1091 +#: ../../library/codecs.rst:1092 msgid "cp1125" msgstr "cp1125" -#: ../../library/codecs.rst:1091 +#: ../../library/codecs.rst:1092 msgid "1125, ibm1125, cp866u, ruscii" msgstr "1125, ibm1125, cp866u, ruscii" -#: ../../library/codecs.rst:1091 ../../library/codecs.rst:1195 +#: ../../library/codecs.rst:1092 ../../library/codecs.rst:1196 msgid "Ukrainian" msgstr "烏克蘭文" -#: ../../library/codecs.rst:1095 +#: ../../library/codecs.rst:1096 msgid "cp1140" msgstr "cp1140" -#: ../../library/codecs.rst:1095 +#: ../../library/codecs.rst:1096 msgid "ibm1140" msgstr "ibm1140" -#: ../../library/codecs.rst:1097 +#: ../../library/codecs.rst:1098 msgid "cp1250" msgstr "cp1250" -#: ../../library/codecs.rst:1097 +#: ../../library/codecs.rst:1098 msgid "windows-1250" msgstr "windows-1250" -#: ../../library/codecs.rst:1099 +#: ../../library/codecs.rst:1100 msgid "cp1251" msgstr "cp1251" -#: ../../library/codecs.rst:1099 +#: ../../library/codecs.rst:1100 msgid "windows-1251" msgstr "windows-1251" -#: ../../library/codecs.rst:1102 +#: ../../library/codecs.rst:1103 msgid "cp1252" msgstr "cp1252" -#: ../../library/codecs.rst:1102 +#: ../../library/codecs.rst:1103 msgid "windows-1252" msgstr "windows-1252" -#: ../../library/codecs.rst:1104 +#: ../../library/codecs.rst:1105 msgid "cp1253" msgstr "cp1253" -#: ../../library/codecs.rst:1104 +#: ../../library/codecs.rst:1105 msgid "windows-1253" msgstr "windows-1253" -#: ../../library/codecs.rst:1106 +#: ../../library/codecs.rst:1107 msgid "cp1254" msgstr "cp1254" -#: ../../library/codecs.rst:1106 +#: ../../library/codecs.rst:1107 msgid "windows-1254" msgstr "windows-1254" -#: ../../library/codecs.rst:1108 +#: ../../library/codecs.rst:1109 msgid "cp1255" msgstr "cp1255" -#: ../../library/codecs.rst:1108 +#: ../../library/codecs.rst:1109 msgid "windows-1255" msgstr "windows-1255" -#: ../../library/codecs.rst:1110 +#: ../../library/codecs.rst:1111 msgid "cp1256" msgstr "cp1256" -#: ../../library/codecs.rst:1110 +#: ../../library/codecs.rst:1111 msgid "windows-1256" msgstr "windows-1256" -#: ../../library/codecs.rst:1112 +#: ../../library/codecs.rst:1113 msgid "cp1257" msgstr "cp1257" -#: ../../library/codecs.rst:1112 +#: ../../library/codecs.rst:1113 msgid "windows-1257" msgstr "windows-1257" -#: ../../library/codecs.rst:1114 +#: ../../library/codecs.rst:1115 msgid "cp1258" msgstr "cp1258" -#: ../../library/codecs.rst:1114 +#: ../../library/codecs.rst:1115 msgid "windows-1258" msgstr "windows-1258" -#: ../../library/codecs.rst:1114 +#: ../../library/codecs.rst:1115 msgid "Vietnamese" msgstr "越南文" -#: ../../library/codecs.rst:1116 +#: ../../library/codecs.rst:1117 msgid "euc_jp" msgstr "euc_jp" -#: ../../library/codecs.rst:1116 +#: ../../library/codecs.rst:1117 msgid "eucjp, ujis, u-jis" msgstr "eucjp, ujis, u-jis" -#: ../../library/codecs.rst:1118 +#: ../../library/codecs.rst:1119 msgid "euc_jis_2004" msgstr "euc_jis_2004" -#: ../../library/codecs.rst:1118 +#: ../../library/codecs.rst:1119 msgid "jisx0213, eucjis2004" msgstr "jisx0213, eucjis2004" -#: ../../library/codecs.rst:1120 +#: ../../library/codecs.rst:1121 msgid "euc_jisx0213" msgstr "euc_jisx0213" -#: ../../library/codecs.rst:1120 +#: ../../library/codecs.rst:1121 msgid "eucjisx0213" msgstr "eucjisx0213" -#: ../../library/codecs.rst:1122 +#: ../../library/codecs.rst:1123 msgid "euc_kr" msgstr "euc_kr" -#: ../../library/codecs.rst:1122 +#: ../../library/codecs.rst:1123 msgid "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" msgstr "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" -#: ../../library/codecs.rst:1126 +#: ../../library/codecs.rst:1127 msgid "gb2312" msgstr "gb2312" -#: ../../library/codecs.rst:1126 +#: ../../library/codecs.rst:1127 msgid "" "chinese, csiso58gb231280, euc-cn, euccn, eucgb2312-cn, gb2312-1980, " "gb2312-80, iso-ir-58" @@ -1813,446 +1813,446 @@ msgstr "" "chinese, csiso58gb231280, euc-cn, euccn, eucgb2312-cn, gb2312-1980, " "gb2312-80, iso-ir-58" -#: ../../library/codecs.rst:1126 ../../library/codecs.rst:1135 +#: ../../library/codecs.rst:1127 ../../library/codecs.rst:1136 msgid "Simplified Chinese" msgstr "簡體中文" -#: ../../library/codecs.rst:1131 +#: ../../library/codecs.rst:1132 msgid "gbk" msgstr "gbk" -#: ../../library/codecs.rst:1131 +#: ../../library/codecs.rst:1132 msgid "936, cp936, ms936" msgstr "936, cp936, ms936" -#: ../../library/codecs.rst:1131 ../../library/codecs.rst:1133 +#: ../../library/codecs.rst:1132 ../../library/codecs.rst:1134 msgid "Unified Chinese" msgstr "" -#: ../../library/codecs.rst:1133 +#: ../../library/codecs.rst:1134 msgid "gb18030" msgstr "gb18030" -#: ../../library/codecs.rst:1133 +#: ../../library/codecs.rst:1134 msgid "gb18030-2000" msgstr "gb18030-2000" -#: ../../library/codecs.rst:1135 +#: ../../library/codecs.rst:1136 msgid "hz" msgstr "" -#: ../../library/codecs.rst:1135 +#: ../../library/codecs.rst:1136 msgid "hzgb, hz-gb, hz-gb-2312" msgstr "hzgb, hz-gb, hz-gb-2312" -#: ../../library/codecs.rst:1137 +#: ../../library/codecs.rst:1138 msgid "iso2022_jp" msgstr "iso2022_jp" -#: ../../library/codecs.rst:1137 +#: ../../library/codecs.rst:1138 msgid "csiso2022jp, iso2022jp, iso-2022-jp" msgstr "csiso2022jp, iso2022jp, iso-2022-jp" -#: ../../library/codecs.rst:1140 +#: ../../library/codecs.rst:1141 msgid "iso2022_jp_1" msgstr "iso2022_jp_1" -#: ../../library/codecs.rst:1140 +#: ../../library/codecs.rst:1141 msgid "iso2022jp-1, iso-2022-jp-1" msgstr "iso2022jp-1, iso-2022-jp-1" -#: ../../library/codecs.rst:1142 +#: ../../library/codecs.rst:1143 msgid "iso2022_jp_2" msgstr "iso2022_jp_2" -#: ../../library/codecs.rst:1142 +#: ../../library/codecs.rst:1143 msgid "iso2022jp-2, iso-2022-jp-2" msgstr "iso2022jp-2, iso-2022-jp-2" -#: ../../library/codecs.rst:1142 +#: ../../library/codecs.rst:1143 msgid "Japanese, Korean, Simplified Chinese, Western Europe, Greek" msgstr "" -#: ../../library/codecs.rst:1145 +#: ../../library/codecs.rst:1146 msgid "iso2022_jp_2004" msgstr "iso2022_jp_2004" -#: ../../library/codecs.rst:1145 +#: ../../library/codecs.rst:1146 msgid "iso2022jp-2004, iso-2022-jp-2004" msgstr "iso2022jp-2004, iso-2022-jp-2004" -#: ../../library/codecs.rst:1148 +#: ../../library/codecs.rst:1149 msgid "iso2022_jp_3" msgstr "iso2022_jp_3" -#: ../../library/codecs.rst:1148 +#: ../../library/codecs.rst:1149 msgid "iso2022jp-3, iso-2022-jp-3" msgstr "iso2022jp-3, iso-2022-jp-3" -#: ../../library/codecs.rst:1150 +#: ../../library/codecs.rst:1151 msgid "iso2022_jp_ext" msgstr "iso2022_jp_ext" -#: ../../library/codecs.rst:1150 +#: ../../library/codecs.rst:1151 msgid "iso2022jp-ext, iso-2022-jp-ext" msgstr "iso2022jp-ext, iso-2022-jp-ext" -#: ../../library/codecs.rst:1152 +#: ../../library/codecs.rst:1153 msgid "iso2022_kr" msgstr "iso2022_kr" -#: ../../library/codecs.rst:1152 +#: ../../library/codecs.rst:1153 msgid "csiso2022kr, iso2022kr, iso-2022-kr" msgstr "csiso2022kr, iso2022kr, iso-2022-kr" -#: ../../library/codecs.rst:1155 +#: ../../library/codecs.rst:1156 msgid "latin_1" msgstr "latin_1" -#: ../../library/codecs.rst:1155 +#: ../../library/codecs.rst:1156 msgid "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" msgstr "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" -#: ../../library/codecs.rst:1158 +#: ../../library/codecs.rst:1159 msgid "iso8859_2" msgstr "iso8859_2" -#: ../../library/codecs.rst:1158 +#: ../../library/codecs.rst:1159 msgid "iso-8859-2, latin2, L2" msgstr "iso-8859-2, latin2, L2" -#: ../../library/codecs.rst:1160 +#: ../../library/codecs.rst:1161 msgid "iso8859_3" msgstr "iso8859_3" -#: ../../library/codecs.rst:1160 +#: ../../library/codecs.rst:1161 msgid "iso-8859-3, latin3, L3" msgstr "iso-8859-3, latin3, L3" -#: ../../library/codecs.rst:1160 +#: ../../library/codecs.rst:1161 msgid "Esperanto, Maltese" msgstr "" -#: ../../library/codecs.rst:1162 +#: ../../library/codecs.rst:1163 msgid "iso8859_4" msgstr "iso8859_4" -#: ../../library/codecs.rst:1162 +#: ../../library/codecs.rst:1163 msgid "iso-8859-4, latin4, L4" msgstr "iso-8859-4, latin4, L4" -#: ../../library/codecs.rst:1164 +#: ../../library/codecs.rst:1165 msgid "iso8859_5" msgstr "iso8859_5" -#: ../../library/codecs.rst:1164 +#: ../../library/codecs.rst:1165 msgid "iso-8859-5, cyrillic" msgstr "iso-8859-5, cyrillic" -#: ../../library/codecs.rst:1167 +#: ../../library/codecs.rst:1168 msgid "iso8859_6" msgstr "iso8859_6" -#: ../../library/codecs.rst:1167 +#: ../../library/codecs.rst:1168 msgid "iso-8859-6, arabic" msgstr "iso-8859-6, arabic" -#: ../../library/codecs.rst:1169 +#: ../../library/codecs.rst:1170 msgid "iso8859_7" msgstr "iso8859_7" -#: ../../library/codecs.rst:1169 +#: ../../library/codecs.rst:1170 msgid "iso-8859-7, greek, greek8" msgstr "iso-8859-7, greek, greek8" -#: ../../library/codecs.rst:1171 +#: ../../library/codecs.rst:1172 msgid "iso8859_8" msgstr "iso8859_8" -#: ../../library/codecs.rst:1171 +#: ../../library/codecs.rst:1172 msgid "iso-8859-8, hebrew" msgstr "iso-8859-8, hebrew" -#: ../../library/codecs.rst:1173 +#: ../../library/codecs.rst:1174 msgid "iso8859_9" msgstr "iso8859_9" -#: ../../library/codecs.rst:1173 +#: ../../library/codecs.rst:1174 msgid "iso-8859-9, latin5, L5" msgstr "iso-8859-9, latin5, L5" -#: ../../library/codecs.rst:1175 +#: ../../library/codecs.rst:1176 msgid "iso8859_10" msgstr "iso8859_10" -#: ../../library/codecs.rst:1175 +#: ../../library/codecs.rst:1176 msgid "iso-8859-10, latin6, L6" msgstr "iso-8859-10, latin6, L6" -#: ../../library/codecs.rst:1175 +#: ../../library/codecs.rst:1176 msgid "Nordic languages" msgstr "" -#: ../../library/codecs.rst:1177 +#: ../../library/codecs.rst:1178 msgid "iso8859_11" msgstr "iso8859_11" -#: ../../library/codecs.rst:1177 +#: ../../library/codecs.rst:1178 msgid "iso-8859-11, thai" msgstr "iso-8859-11, thai" -#: ../../library/codecs.rst:1177 +#: ../../library/codecs.rst:1178 msgid "Thai languages" msgstr "" -#: ../../library/codecs.rst:1179 +#: ../../library/codecs.rst:1180 msgid "iso8859_13" msgstr "iso8859_13" -#: ../../library/codecs.rst:1179 +#: ../../library/codecs.rst:1180 msgid "iso-8859-13, latin7, L7" msgstr "iso-8859-13, latin7, L7" -#: ../../library/codecs.rst:1181 +#: ../../library/codecs.rst:1182 msgid "iso8859_14" msgstr "iso8859_14" -#: ../../library/codecs.rst:1181 +#: ../../library/codecs.rst:1182 msgid "iso-8859-14, latin8, L8" msgstr "iso-8859-14, latin8, L8" -#: ../../library/codecs.rst:1181 +#: ../../library/codecs.rst:1182 msgid "Celtic languages" msgstr "" -#: ../../library/codecs.rst:1183 +#: ../../library/codecs.rst:1184 msgid "iso8859_15" msgstr "iso8859_15" -#: ../../library/codecs.rst:1183 +#: ../../library/codecs.rst:1184 msgid "iso-8859-15, latin9, L9" msgstr "iso-8859-15, latin9, L9" -#: ../../library/codecs.rst:1185 +#: ../../library/codecs.rst:1186 msgid "iso8859_16" msgstr "iso8859_16" -#: ../../library/codecs.rst:1185 +#: ../../library/codecs.rst:1186 msgid "iso-8859-16, latin10, L10" msgstr "iso-8859-16, latin10, L10" -#: ../../library/codecs.rst:1185 +#: ../../library/codecs.rst:1186 msgid "South-Eastern Europe" msgstr "" -#: ../../library/codecs.rst:1187 +#: ../../library/codecs.rst:1188 msgid "johab" msgstr "" -#: ../../library/codecs.rst:1187 +#: ../../library/codecs.rst:1188 msgid "cp1361, ms1361" msgstr "cp1361, ms1361" -#: ../../library/codecs.rst:1189 +#: ../../library/codecs.rst:1190 msgid "koi8_r" msgstr "koi8_r" -#: ../../library/codecs.rst:1191 +#: ../../library/codecs.rst:1192 msgid "koi8_t" msgstr "koi8_t" -#: ../../library/codecs.rst:1191 +#: ../../library/codecs.rst:1192 msgid "Tajik" msgstr "" -#: ../../library/codecs.rst:1195 +#: ../../library/codecs.rst:1196 msgid "koi8_u" msgstr "koi8_u" -#: ../../library/codecs.rst:1197 +#: ../../library/codecs.rst:1198 msgid "kz1048" msgstr "kz1048" -#: ../../library/codecs.rst:1197 +#: ../../library/codecs.rst:1198 msgid "kz_1048, strk1048_2002, rk1048" msgstr "kz_1048, strk1048_2002, rk1048" -#: ../../library/codecs.rst:1197 ../../library/codecs.rst:1215 +#: ../../library/codecs.rst:1198 ../../library/codecs.rst:1216 msgid "Kazakh" msgstr "" -#: ../../library/codecs.rst:1201 +#: ../../library/codecs.rst:1202 msgid "mac_cyrillic" msgstr "mac_cyrillic" -#: ../../library/codecs.rst:1201 +#: ../../library/codecs.rst:1202 msgid "maccyrillic" msgstr "" -#: ../../library/codecs.rst:1204 +#: ../../library/codecs.rst:1205 msgid "mac_greek" msgstr "mac_greek" -#: ../../library/codecs.rst:1204 +#: ../../library/codecs.rst:1205 msgid "macgreek" msgstr "" -#: ../../library/codecs.rst:1206 +#: ../../library/codecs.rst:1207 msgid "mac_iceland" msgstr "mac_iceland" -#: ../../library/codecs.rst:1206 +#: ../../library/codecs.rst:1207 msgid "maciceland" msgstr "" -#: ../../library/codecs.rst:1208 +#: ../../library/codecs.rst:1209 msgid "mac_latin2" msgstr "mac_latin2" -#: ../../library/codecs.rst:1208 +#: ../../library/codecs.rst:1209 msgid "maclatin2, maccentraleurope, mac_centeuro" msgstr "maclatin2, maccentraleurope, mac_centeuro" -#: ../../library/codecs.rst:1211 +#: ../../library/codecs.rst:1212 msgid "mac_roman" msgstr "mac_roman" -#: ../../library/codecs.rst:1211 +#: ../../library/codecs.rst:1212 msgid "macroman, macintosh" msgstr "macroman, macintosh" -#: ../../library/codecs.rst:1213 +#: ../../library/codecs.rst:1214 msgid "mac_turkish" msgstr "mac_turkish" -#: ../../library/codecs.rst:1213 +#: ../../library/codecs.rst:1214 msgid "macturkish" msgstr "" -#: ../../library/codecs.rst:1215 +#: ../../library/codecs.rst:1216 msgid "ptcp154" msgstr "ptcp154" -#: ../../library/codecs.rst:1215 +#: ../../library/codecs.rst:1216 msgid "csptcp154, pt154, cp154, cyrillic-asian" msgstr "csptcp154, pt154, cp154, cyrillic-asian" -#: ../../library/codecs.rst:1218 +#: ../../library/codecs.rst:1219 msgid "shift_jis" msgstr "shift_jis" -#: ../../library/codecs.rst:1218 +#: ../../library/codecs.rst:1219 msgid "csshiftjis, shiftjis, sjis, s_jis" msgstr "csshiftjis, shiftjis, sjis, s_jis" -#: ../../library/codecs.rst:1221 +#: ../../library/codecs.rst:1222 msgid "shift_jis_2004" msgstr "shift_jis_2004" -#: ../../library/codecs.rst:1221 +#: ../../library/codecs.rst:1222 msgid "shiftjis2004, sjis_2004, sjis2004" msgstr "shiftjis2004, sjis_2004, sjis2004" -#: ../../library/codecs.rst:1224 +#: ../../library/codecs.rst:1225 msgid "shift_jisx0213" msgstr "shift_jisx0213" -#: ../../library/codecs.rst:1224 +#: ../../library/codecs.rst:1225 msgid "shiftjisx0213, sjisx0213, s_jisx0213" msgstr "shiftjisx0213, sjisx0213, s_jisx0213" -#: ../../library/codecs.rst:1227 +#: ../../library/codecs.rst:1228 msgid "utf_32" msgstr "utf_32" -#: ../../library/codecs.rst:1227 +#: ../../library/codecs.rst:1228 msgid "U32, utf32" msgstr "U32, utf32" -#: ../../library/codecs.rst:1227 ../../library/codecs.rst:1229 -#: ../../library/codecs.rst:1231 ../../library/codecs.rst:1233 -#: ../../library/codecs.rst:1235 ../../library/codecs.rst:1237 -#: ../../library/codecs.rst:1239 ../../library/codecs.rst:1241 -#: ../../library/codecs.rst:1243 +#: ../../library/codecs.rst:1228 ../../library/codecs.rst:1230 +#: ../../library/codecs.rst:1232 ../../library/codecs.rst:1234 +#: ../../library/codecs.rst:1236 ../../library/codecs.rst:1238 +#: ../../library/codecs.rst:1240 ../../library/codecs.rst:1242 +#: ../../library/codecs.rst:1244 msgid "all languages" msgstr "" -#: ../../library/codecs.rst:1229 +#: ../../library/codecs.rst:1230 msgid "utf_32_be" msgstr "utf_32_be" -#: ../../library/codecs.rst:1229 +#: ../../library/codecs.rst:1230 msgid "UTF-32BE" msgstr "UTF-32BE" -#: ../../library/codecs.rst:1231 +#: ../../library/codecs.rst:1232 msgid "utf_32_le" msgstr "utf_32_le" -#: ../../library/codecs.rst:1231 +#: ../../library/codecs.rst:1232 msgid "UTF-32LE" msgstr "UTF-32LE" -#: ../../library/codecs.rst:1233 +#: ../../library/codecs.rst:1234 msgid "utf_16" msgstr "utf_16" -#: ../../library/codecs.rst:1233 +#: ../../library/codecs.rst:1234 msgid "U16, utf16" msgstr "U16, utf16" -#: ../../library/codecs.rst:1235 +#: ../../library/codecs.rst:1236 msgid "utf_16_be" msgstr "utf_16_be" -#: ../../library/codecs.rst:1235 +#: ../../library/codecs.rst:1236 msgid "UTF-16BE" msgstr "UTF-16BE" -#: ../../library/codecs.rst:1237 +#: ../../library/codecs.rst:1238 msgid "utf_16_le" msgstr "utf_16_le" -#: ../../library/codecs.rst:1237 +#: ../../library/codecs.rst:1238 msgid "UTF-16LE" msgstr "UTF-16LE" -#: ../../library/codecs.rst:1239 +#: ../../library/codecs.rst:1240 msgid "utf_7" msgstr "utf_7" -#: ../../library/codecs.rst:1239 +#: ../../library/codecs.rst:1240 msgid "U7, unicode-1-1-utf-7" msgstr "U7, unicode-1-1-utf-7" -#: ../../library/codecs.rst:1241 +#: ../../library/codecs.rst:1242 msgid "utf_8" msgstr "utf_8" -#: ../../library/codecs.rst:1241 +#: ../../library/codecs.rst:1242 msgid "U8, UTF, utf8, cp65001" msgstr "U8, UTF, utf8, cp65001" -#: ../../library/codecs.rst:1243 +#: ../../library/codecs.rst:1244 msgid "utf_8_sig" msgstr "utf_8_sig" -#: ../../library/codecs.rst:1246 +#: ../../library/codecs.rst:1247 msgid "" "The utf-16\\* and utf-32\\* encoders no longer allow surrogate code points " "(``U+D800``--``U+DFFF``) to be encoded. The utf-32\\* decoders no longer " "decode byte sequences that correspond to surrogate code points." msgstr "" -#: ../../library/codecs.rst:1252 +#: ../../library/codecs.rst:1253 msgid "``cp65001`` is now an alias to ``utf_8``." msgstr "" -#: ../../library/codecs.rst:1257 +#: ../../library/codecs.rst:1258 msgid "Python Specific Encodings" msgstr "" -#: ../../library/codecs.rst:1259 +#: ../../library/codecs.rst:1260 msgid "" "A number of predefined codecs are specific to Python, so their codec names " "have no meaning outside Python. These are listed in the tables below based " @@ -2262,272 +2262,272 @@ msgid "" "asymmetric codecs, the stated meaning describes the encoding direction." msgstr "" -#: ../../library/codecs.rst:1267 +#: ../../library/codecs.rst:1268 msgid "Text Encodings" msgstr "" -#: ../../library/codecs.rst:1269 +#: ../../library/codecs.rst:1270 msgid "" "The following codecs provide :class:`str` to :class:`bytes` encoding and :" "term:`bytes-like object` to :class:`str` decoding, similar to the Unicode " "text encodings." msgstr "" -#: ../../library/codecs.rst:1278 +#: ../../library/codecs.rst:1279 msgid "idna" msgstr "idna" -#: ../../library/codecs.rst:1278 +#: ../../library/codecs.rst:1279 msgid "" "Implement :rfc:`3490`, see also :mod:`encodings.idna`. Only " "``errors='strict'`` is supported." msgstr "" -#: ../../library/codecs.rst:1284 +#: ../../library/codecs.rst:1285 msgid "mbcs" msgstr "mbcs" -#: ../../library/codecs.rst:1284 +#: ../../library/codecs.rst:1285 msgid "ansi, dbcs" msgstr "ansi, dbcs" -#: ../../library/codecs.rst:1284 +#: ../../library/codecs.rst:1285 msgid "" "Windows only: Encode the operand according to the ANSI codepage (CP_ACP)." msgstr "" -#: ../../library/codecs.rst:1288 +#: ../../library/codecs.rst:1289 msgid "oem" msgstr "oem" -#: ../../library/codecs.rst:1288 +#: ../../library/codecs.rst:1289 msgid "" "Windows only: Encode the operand according to the OEM codepage (CP_OEMCP)." msgstr "" -#: ../../library/codecs.rst:1294 +#: ../../library/codecs.rst:1295 msgid "palmos" msgstr "" -#: ../../library/codecs.rst:1294 +#: ../../library/codecs.rst:1295 msgid "Encoding of PalmOS 3.5." msgstr "" -#: ../../library/codecs.rst:1296 +#: ../../library/codecs.rst:1297 msgid "punycode" msgstr "" -#: ../../library/codecs.rst:1296 +#: ../../library/codecs.rst:1297 msgid "Implement :rfc:`3492`. Stateful codecs are not supported." msgstr "" -#: ../../library/codecs.rst:1300 +#: ../../library/codecs.rst:1301 msgid "raw_unicode_escape" msgstr "raw_unicode_escape" -#: ../../library/codecs.rst:1300 +#: ../../library/codecs.rst:1301 msgid "" "Latin-1 encoding with ``\\uXXXX`` and ``\\UXXXXXXXX`` for other code points. " "Existing backslashes are not escaped in any way. It is used in the Python " "pickle protocol." msgstr "" -#: ../../library/codecs.rst:1309 +#: ../../library/codecs.rst:1310 msgid "undefined" msgstr "" -#: ../../library/codecs.rst:1309 +#: ../../library/codecs.rst:1310 msgid "" "Raise an exception for all conversions, even empty strings. The error " "handler is ignored." msgstr "" -#: ../../library/codecs.rst:1314 +#: ../../library/codecs.rst:1315 msgid "unicode_escape" msgstr "unicode_escape" -#: ../../library/codecs.rst:1314 +#: ../../library/codecs.rst:1315 msgid "" "Encoding suitable as the contents of a Unicode literal in ASCII-encoded " "Python source code, except that quotes are not escaped. Decode from Latin-1 " "source code. Beware that Python source code actually uses UTF-8 by default." msgstr "" -#: ../../library/codecs.rst:1326 +#: ../../library/codecs.rst:1327 msgid "\"unicode_internal\" codec is removed." msgstr "" -#: ../../library/codecs.rst:1333 +#: ../../library/codecs.rst:1334 msgid "Binary Transforms" msgstr "" -#: ../../library/codecs.rst:1335 +#: ../../library/codecs.rst:1336 msgid "" "The following codecs provide binary transforms: :term:`bytes-like object` " "to :class:`bytes` mappings. They are not supported by :meth:`bytes.decode` " "(which only produces :class:`str` output)." msgstr "" -#: ../../library/codecs.rst:1343 +#: ../../library/codecs.rst:1344 msgid "Encoder / decoder" msgstr "" -#: ../../library/codecs.rst:1345 +#: ../../library/codecs.rst:1346 msgid "base64_codec [#b64]_" msgstr "base64_codec [#b64]_" -#: ../../library/codecs.rst:1345 +#: ../../library/codecs.rst:1346 msgid "base64, base_64" msgstr "base64, base_64" -#: ../../library/codecs.rst:1345 +#: ../../library/codecs.rst:1346 msgid "" "Convert the operand to multiline MIME base64 (the result always includes a " "trailing ``'\\n'``)." msgstr "" -#: ../../library/codecs.rst:1350 +#: ../../library/codecs.rst:1351 msgid "" "accepts any :term:`bytes-like object` as input for encoding and decoding" msgstr "" -#: ../../library/codecs.rst:1345 +#: ../../library/codecs.rst:1346 msgid ":meth:`base64.encodebytes` / :meth:`base64.decodebytes`" msgstr ":meth:`base64.encodebytes` / :meth:`base64.decodebytes`" -#: ../../library/codecs.rst:1356 +#: ../../library/codecs.rst:1357 msgid "bz2_codec" msgstr "bz2_codec" -#: ../../library/codecs.rst:1356 +#: ../../library/codecs.rst:1357 msgid "bz2" msgstr "bz2" -#: ../../library/codecs.rst:1356 +#: ../../library/codecs.rst:1357 msgid "Compress the operand using bz2." msgstr "" -#: ../../library/codecs.rst:1356 +#: ../../library/codecs.rst:1357 msgid ":meth:`bz2.compress` / :meth:`bz2.decompress`" msgstr ":meth:`bz2.compress` / :meth:`bz2.decompress`" -#: ../../library/codecs.rst:1359 +#: ../../library/codecs.rst:1360 msgid "hex_codec" msgstr "hex_codec" -#: ../../library/codecs.rst:1359 +#: ../../library/codecs.rst:1360 msgid "hex" msgstr "hex" -#: ../../library/codecs.rst:1359 +#: ../../library/codecs.rst:1360 msgid "" "Convert the operand to hexadecimal representation, with two digits per byte." msgstr "" -#: ../../library/codecs.rst:1359 +#: ../../library/codecs.rst:1360 msgid ":meth:`binascii.b2a_hex` / :meth:`binascii.a2b_hex`" msgstr ":meth:`binascii.b2a_hex` / :meth:`binascii.a2b_hex`" -#: ../../library/codecs.rst:1364 +#: ../../library/codecs.rst:1365 msgid "quopri_codec" msgstr "quopri_codec" -#: ../../library/codecs.rst:1364 +#: ../../library/codecs.rst:1365 msgid "quopri, quotedprintable, quoted_printable" msgstr "quopri, quotedprintable, quoted_printable" -#: ../../library/codecs.rst:1364 +#: ../../library/codecs.rst:1365 msgid "Convert the operand to MIME quoted printable." msgstr "" -#: ../../library/codecs.rst:1364 +#: ../../library/codecs.rst:1365 msgid ":meth:`quopri.encode` with ``quotetabs=True`` / :meth:`quopri.decode`" msgstr ":meth:`quopri.encode` with ``quotetabs=True`` / :meth:`quopri.decode`" -#: ../../library/codecs.rst:1368 +#: ../../library/codecs.rst:1369 msgid "uu_codec" msgstr "uu_codec" -#: ../../library/codecs.rst:1368 +#: ../../library/codecs.rst:1369 msgid "uu" msgstr "uu" -#: ../../library/codecs.rst:1368 +#: ../../library/codecs.rst:1369 msgid "Convert the operand using uuencode." msgstr "" -#: ../../library/codecs.rst:1368 +#: ../../library/codecs.rst:1369 msgid ":meth:`uu.encode` / :meth:`uu.decode`" msgstr ":meth:`uu.encode` / :meth:`uu.decode`" -#: ../../library/codecs.rst:1371 +#: ../../library/codecs.rst:1372 msgid "zlib_codec" msgstr "zlib_codec" -#: ../../library/codecs.rst:1371 +#: ../../library/codecs.rst:1372 msgid "zip, zlib" msgstr "zip, zlib" -#: ../../library/codecs.rst:1371 +#: ../../library/codecs.rst:1372 msgid "Compress the operand using gzip." msgstr "" -#: ../../library/codecs.rst:1371 +#: ../../library/codecs.rst:1372 msgid ":meth:`zlib.compress` / :meth:`zlib.decompress`" msgstr ":meth:`zlib.compress` / :meth:`zlib.decompress`" -#: ../../library/codecs.rst:1375 +#: ../../library/codecs.rst:1376 msgid "" "In addition to :term:`bytes-like objects `, " "``'base64_codec'`` also accepts ASCII-only instances of :class:`str` for " "decoding" msgstr "" -#: ../../library/codecs.rst:1379 +#: ../../library/codecs.rst:1380 msgid "Restoration of the binary transforms." msgstr "" -#: ../../library/codecs.rst:1382 +#: ../../library/codecs.rst:1383 msgid "Restoration of the aliases for the binary transforms." msgstr "" -#: ../../library/codecs.rst:1389 +#: ../../library/codecs.rst:1390 msgid "Text Transforms" msgstr "" -#: ../../library/codecs.rst:1391 +#: ../../library/codecs.rst:1392 msgid "" "The following codec provides a text transform: a :class:`str` to :class:" "`str` mapping. It is not supported by :meth:`str.encode` (which only " "produces :class:`bytes` output)." msgstr "" -#: ../../library/codecs.rst:1400 +#: ../../library/codecs.rst:1401 msgid "rot_13" msgstr "rot_13" -#: ../../library/codecs.rst:1400 +#: ../../library/codecs.rst:1401 msgid "rot13" msgstr "" -#: ../../library/codecs.rst:1400 +#: ../../library/codecs.rst:1401 msgid "Return the Caesar-cypher encryption of the operand." msgstr "" -#: ../../library/codecs.rst:1405 +#: ../../library/codecs.rst:1406 msgid "Restoration of the ``rot_13`` text transform." msgstr "" -#: ../../library/codecs.rst:1408 +#: ../../library/codecs.rst:1409 msgid "Restoration of the ``rot13`` alias." msgstr "" -#: ../../library/codecs.rst:1413 +#: ../../library/codecs.rst:1414 msgid "" ":mod:`encodings.idna` --- Internationalized Domain Names in Applications" msgstr "" -#: ../../library/codecs.rst:1419 +#: ../../library/codecs.rst:1420 msgid "" "This module implements :rfc:`3490` (Internationalized Domain Names in " "Applications) and :rfc:`3492` (Nameprep: A Stringprep Profile for " @@ -2535,13 +2535,13 @@ msgid "" "encoding and :mod:`stringprep`." msgstr "" -#: ../../library/codecs.rst:1424 +#: ../../library/codecs.rst:1425 msgid "" "If you need the IDNA 2008 standard from :rfc:`5891` and :rfc:`5895`, use the " "third-party `idna module _`." msgstr "" -#: ../../library/codecs.rst:1427 +#: ../../library/codecs.rst:1428 msgid "" "These RFCs together define a protocol to support non-ASCII characters in " "domain names. A domain name containing non-ASCII characters (such as ``www." @@ -2555,7 +2555,7 @@ msgid "" "presenting them to the user." msgstr "" -#: ../../library/codecs.rst:1438 +#: ../../library/codecs.rst:1439 msgid "" "Python supports this conversion in several ways: the ``idna`` codec " "performs conversion between Unicode and ACE, separating an input string into " @@ -2572,14 +2572,14 @@ msgid "" "sends that field at all)." msgstr "" -#: ../../library/codecs.rst:1451 +#: ../../library/codecs.rst:1452 msgid "" "When receiving host names from the wire (such as in reverse name lookup), no " "automatic conversion to Unicode is performed: applications wishing to " "present such host names to the user should decode them to Unicode." msgstr "" -#: ../../library/codecs.rst:1455 +#: ../../library/codecs.rst:1456 msgid "" "The module :mod:`encodings.idna` also implements the nameprep procedure, " "which performs certain normalizations on host names, to achieve case-" @@ -2587,49 +2587,49 @@ msgid "" "characters. The nameprep functions can be used directly if desired." msgstr "" -#: ../../library/codecs.rst:1463 +#: ../../library/codecs.rst:1464 msgid "" "Return the nameprepped version of *label*. The implementation currently " "assumes query strings, so ``AllowUnassigned`` is true." msgstr "" -#: ../../library/codecs.rst:1469 +#: ../../library/codecs.rst:1470 msgid "" "Convert a label to ASCII, as specified in :rfc:`3490`. ``UseSTD3ASCIIRules`` " "is assumed to be false." msgstr "" -#: ../../library/codecs.rst:1475 +#: ../../library/codecs.rst:1476 msgid "Convert a label to Unicode, as specified in :rfc:`3490`." msgstr "" -#: ../../library/codecs.rst:1479 +#: ../../library/codecs.rst:1480 msgid ":mod:`encodings.mbcs` --- Windows ANSI codepage" msgstr "" -#: ../../library/codecs.rst:1484 +#: ../../library/codecs.rst:1485 msgid "This module implements the ANSI codepage (CP_ACP)." msgstr "" -#: ../../library/codecs.rst:1487 +#: ../../library/codecs.rst:1488 msgid ":ref:`Availability `: Windows only." msgstr ":ref:`適用 `：只有 Windows。" -#: ../../library/codecs.rst:1488 +#: ../../library/codecs.rst:1489 msgid "Support any error handler." msgstr "" -#: ../../library/codecs.rst:1491 +#: ../../library/codecs.rst:1492 msgid "" "Before 3.2, the *errors* argument was ignored; ``'replace'`` was always used " "to encode, and ``'ignore'`` to decode." msgstr "" -#: ../../library/codecs.rst:1497 +#: ../../library/codecs.rst:1498 msgid ":mod:`encodings.utf_8_sig` --- UTF-8 codec with BOM signature" msgstr "" -#: ../../library/codecs.rst:1503 +#: ../../library/codecs.rst:1504 msgid "" "This module implements a variant of the UTF-8 codec. On encoding, a UTF-8 " "encoded BOM will be prepended to the UTF-8 encoded bytes. For the stateful " diff --git a/library/sys.po b/library/sys.po index 6e74a01366..fec423357b 100644 --- a/library/sys.po +++ b/library/sys.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-11-19 00:09+0000\n" +"POT-Creation-Date: 2022-03-04 00:14+0000\n" "PO-Revision-Date: 2018-05-23 16:12+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -334,8 +334,8 @@ msgstr "" msgid "Integer specifying the handle of the Python DLL." msgstr "" -#: ../../library/sys.rst:269 ../../library/sys.rst:810 -#: ../../library/sys.rst:1488 ../../library/sys.rst:1718 +#: ../../library/sys.rst:269 ../../library/sys.rst:808 +#: ../../library/sys.rst:1486 ../../library/sys.rst:1716 msgid ":ref:`Availability `: Windows." msgstr ":ref:`適用 `：Windows。" @@ -506,13 +506,11 @@ msgstr "" #: ../../library/sys.rst:432 msgid "" -"Exit from Python. This is implemented by raising the :exc:`SystemExit` " -"exception, so cleanup actions specified by finally clauses of :keyword:`try` " -"statements are honored, and it is possible to intercept the exit attempt at " -"an outer level." +"Raise a :exc:`SystemExit` exception, signaling an intention to exit the " +"interpreter." msgstr "" -#: ../../library/sys.rst:437 +#: ../../library/sys.rst:434 msgid "" "The optional argument *arg* can be an integer giving the exit status " "(defaulting to zero), or another type of object. If it is an integer, zero " @@ -528,175 +526,177 @@ msgid "" "way to exit a program when an error occurs." msgstr "" -#: ../../library/sys.rst:450 +#: ../../library/sys.rst:447 msgid "" "Since :func:`exit` ultimately \"only\" raises an exception, it will only " "exit the process when called from the main thread, and the exception is not " -"intercepted." +"intercepted. Cleanup actions specified by finally clauses of :keyword:`try` " +"statements are honored, and it is possible to intercept the exit attempt at " +"an outer level." msgstr "" -#: ../../library/sys.rst:454 +#: ../../library/sys.rst:452 msgid "" "If an error occurs in the cleanup after the Python interpreter has caught :" "exc:`SystemExit` (such as an error flushing buffered data in the standard " "streams), the exit status is changed to 120." msgstr "" -#: ../../library/sys.rst:462 +#: ../../library/sys.rst:460 msgid "" "The :term:`named tuple` *flags* exposes the status of command line flags. " "The attributes are read only." msgstr "" -#: ../../library/sys.rst:466 ../../library/sys.rst:515 -#: ../../library/sys.rst:855 +#: ../../library/sys.rst:464 ../../library/sys.rst:513 +#: ../../library/sys.rst:853 msgid "attribute" msgstr "" -#: ../../library/sys.rst:466 +#: ../../library/sys.rst:464 msgid "flag" msgstr "" -#: ../../library/sys.rst:468 +#: ../../library/sys.rst:466 msgid ":const:`debug`" msgstr ":const:`debug`" -#: ../../library/sys.rst:468 +#: ../../library/sys.rst:466 msgid ":option:`-d`" msgstr ":option:`-d`" -#: ../../library/sys.rst:469 +#: ../../library/sys.rst:467 msgid ":const:`inspect`" msgstr ":const:`inspect`" -#: ../../library/sys.rst:469 ../../library/sys.rst:470 +#: ../../library/sys.rst:467 ../../library/sys.rst:468 msgid ":option:`-i`" msgstr ":option:`-i`" -#: ../../library/sys.rst:470 +#: ../../library/sys.rst:468 msgid ":const:`interactive`" msgstr ":const:`interactive`" -#: ../../library/sys.rst:471 +#: ../../library/sys.rst:469 msgid ":const:`isolated`" msgstr ":const:`isolated`" -#: ../../library/sys.rst:471 +#: ../../library/sys.rst:469 msgid ":option:`-I`" msgstr ":option:`-I`" -#: ../../library/sys.rst:472 +#: ../../library/sys.rst:470 msgid ":const:`optimize`" msgstr ":const:`optimize`" -#: ../../library/sys.rst:472 +#: ../../library/sys.rst:470 msgid ":option:`-O` or :option:`-OO`" msgstr ":option:`-O` 或 :option:`-OO`" -#: ../../library/sys.rst:473 +#: ../../library/sys.rst:471 msgid ":const:`dont_write_bytecode`" msgstr ":const:`dont_write_bytecode`" -#: ../../library/sys.rst:473 +#: ../../library/sys.rst:471 msgid ":option:`-B`" msgstr ":option:`-B`" -#: ../../library/sys.rst:474 +#: ../../library/sys.rst:472 msgid ":const:`no_user_site`" msgstr ":const:`no_user_site`" -#: ../../library/sys.rst:474 +#: ../../library/sys.rst:472 msgid ":option:`-s`" msgstr ":option:`-s`" -#: ../../library/sys.rst:475 +#: ../../library/sys.rst:473 msgid ":const:`no_site`" msgstr ":const:`no_site`" -#: ../../library/sys.rst:475 +#: ../../library/sys.rst:473 msgid ":option:`-S`" msgstr ":option:`-S`" -#: ../../library/sys.rst:476 +#: ../../library/sys.rst:474 msgid ":const:`ignore_environment`" msgstr ":const:`ignore_environment`" -#: ../../library/sys.rst:476 +#: ../../library/sys.rst:474 msgid ":option:`-E`" msgstr ":option:`-E`" -#: ../../library/sys.rst:477 +#: ../../library/sys.rst:475 msgid ":const:`verbose`" msgstr ":const:`verbose`" -#: ../../library/sys.rst:477 +#: ../../library/sys.rst:475 msgid ":option:`-v`" msgstr ":option:`-v`" -#: ../../library/sys.rst:478 +#: ../../library/sys.rst:476 msgid ":const:`bytes_warning`" msgstr ":const:`bytes_warning`" -#: ../../library/sys.rst:478 +#: ../../library/sys.rst:476 msgid ":option:`-b`" msgstr ":option:`-b`" -#: ../../library/sys.rst:479 +#: ../../library/sys.rst:477 msgid ":const:`quiet`" msgstr ":const:`quiet`" -#: ../../library/sys.rst:479 +#: ../../library/sys.rst:477 msgid ":option:`-q`" msgstr ":option:`-q`" -#: ../../library/sys.rst:480 +#: ../../library/sys.rst:478 msgid ":const:`hash_randomization`" msgstr ":const:`hash_randomization`" -#: ../../library/sys.rst:480 +#: ../../library/sys.rst:478 msgid ":option:`-R`" msgstr ":option:`-R`" -#: ../../library/sys.rst:481 +#: ../../library/sys.rst:479 msgid ":const:`dev_mode`" msgstr ":const:`dev_mode`" -#: ../../library/sys.rst:481 +#: ../../library/sys.rst:479 msgid ":option:`-X dev <-X>` (:ref:`Python Development Mode `)" msgstr "" -#: ../../library/sys.rst:482 +#: ../../library/sys.rst:480 msgid ":const:`utf8_mode`" msgstr ":const:`utf8_mode`" -#: ../../library/sys.rst:482 +#: ../../library/sys.rst:480 msgid ":option:`-X utf8 <-X>`" msgstr ":option:`-X utf8 <-X>`" -#: ../../library/sys.rst:485 +#: ../../library/sys.rst:483 msgid "Added ``quiet`` attribute for the new :option:`-q` flag." msgstr "" -#: ../../library/sys.rst:488 +#: ../../library/sys.rst:486 msgid "The ``hash_randomization`` attribute." msgstr "" -#: ../../library/sys.rst:491 +#: ../../library/sys.rst:489 msgid "Removed obsolete ``division_warning`` attribute." msgstr "" -#: ../../library/sys.rst:494 +#: ../../library/sys.rst:492 msgid "Added ``isolated`` attribute for :option:`-I` ``isolated`` flag." msgstr "" -#: ../../library/sys.rst:497 +#: ../../library/sys.rst:495 msgid "" "Added the ``dev_mode`` attribute for the new :ref:`Python Development Mode " "` and the ``utf8_mode`` attribute for the new :option:`-X` " "``utf8`` flag." msgstr "" -#: ../../library/sys.rst:505 +#: ../../library/sys.rst:503 msgid "" "A :term:`named tuple` holding information about the float type. It contains " "low level information about the precision and internal representation. The " @@ -706,163 +706,163 @@ msgid "" "floating types', for details." msgstr "" -#: ../../library/sys.rst:515 +#: ../../library/sys.rst:513 msgid "float.h macro" msgstr "" -#: ../../library/sys.rst:515 ../../library/sys.rst:855 +#: ../../library/sys.rst:513 ../../library/sys.rst:853 msgid "explanation" msgstr "" -#: ../../library/sys.rst:517 +#: ../../library/sys.rst:515 msgid ":const:`epsilon`" msgstr ":const:`epsilon`" -#: ../../library/sys.rst:517 +#: ../../library/sys.rst:515 msgid "DBL_EPSILON" msgstr "DBL_EPSILON" -#: ../../library/sys.rst:517 +#: ../../library/sys.rst:515 msgid "" "difference between 1.0 and the least value greater than 1.0 that is " "representable as a float" msgstr "" -#: ../../library/sys.rst:520 +#: ../../library/sys.rst:518 msgid "See also :func:`math.ulp`." msgstr "另請參閱 :func:`math.ulp`\\ 。" -#: ../../library/sys.rst:522 +#: ../../library/sys.rst:520 msgid ":const:`dig`" msgstr ":const:`dig`" -#: ../../library/sys.rst:522 +#: ../../library/sys.rst:520 msgid "DBL_DIG" msgstr "DBL_DIG" -#: ../../library/sys.rst:522 +#: ../../library/sys.rst:520 msgid "" "maximum number of decimal digits that can be faithfully represented in a " "float; see below" msgstr "" -#: ../../library/sys.rst:525 +#: ../../library/sys.rst:523 msgid ":const:`mant_dig`" msgstr ":const:`mant_dig`" -#: ../../library/sys.rst:525 +#: ../../library/sys.rst:523 msgid "DBL_MANT_DIG" msgstr "DBL_MANT_DIG" -#: ../../library/sys.rst:525 +#: ../../library/sys.rst:523 msgid "" "float precision: the number of base-``radix`` digits in the significand of a " "float" msgstr "" -#: ../../library/sys.rst:528 +#: ../../library/sys.rst:526 msgid ":const:`max`" msgstr ":const:`max`" -#: ../../library/sys.rst:528 +#: ../../library/sys.rst:526 msgid "DBL_MAX" msgstr "DBL_MAX" -#: ../../library/sys.rst:528 +#: ../../library/sys.rst:526 msgid "maximum representable positive finite float" msgstr "" -#: ../../library/sys.rst:530 +#: ../../library/sys.rst:528 msgid ":const:`max_exp`" msgstr ":const:`max_exp`" -#: ../../library/sys.rst:530 +#: ../../library/sys.rst:528 msgid "DBL_MAX_EXP" msgstr "DBL_MAX_EXP" -#: ../../library/sys.rst:530 +#: ../../library/sys.rst:528 msgid "" "maximum integer *e* such that ``radix**(e-1)`` is a representable finite " "float" msgstr "" -#: ../../library/sys.rst:533 +#: ../../library/sys.rst:531 msgid ":const:`max_10_exp`" msgstr ":const:`max_10_exp`" -#: ../../library/sys.rst:533 +#: ../../library/sys.rst:531 msgid "DBL_MAX_10_EXP" msgstr "DBL_MAX_10_EXP" -#: ../../library/sys.rst:533 +#: ../../library/sys.rst:531 msgid "" "maximum integer *e* such that ``10**e`` is in the range of representable " "finite floats" msgstr "" -#: ../../library/sys.rst:536 +#: ../../library/sys.rst:534 msgid ":const:`min`" msgstr ":const:`min`" -#: ../../library/sys.rst:536 +#: ../../library/sys.rst:534 msgid "DBL_MIN" msgstr "DBL_MIN" -#: ../../library/sys.rst:536 +#: ../../library/sys.rst:534 msgid "minimum representable positive *normalized* float" msgstr "" -#: ../../library/sys.rst:538 +#: ../../library/sys.rst:536 msgid "" "Use :func:`math.ulp(0.0) ` to get the smallest positive " "*denormalized* representable float." msgstr "" -#: ../../library/sys.rst:542 +#: ../../library/sys.rst:540 msgid ":const:`min_exp`" msgstr ":const:`min_exp`" -#: ../../library/sys.rst:542 +#: ../../library/sys.rst:540 msgid "DBL_MIN_EXP" msgstr "DBL_MIN_EXP" -#: ../../library/sys.rst:542 +#: ../../library/sys.rst:540 msgid "minimum integer *e* such that ``radix**(e-1)`` is a normalized float" msgstr "" -#: ../../library/sys.rst:545 +#: ../../library/sys.rst:543 msgid ":const:`min_10_exp`" msgstr ":const:`min_10_exp`" -#: ../../library/sys.rst:545 +#: ../../library/sys.rst:543 msgid "DBL_MIN_10_EXP" msgstr "DBL_MIN_10_EXP" -#: ../../library/sys.rst:545 +#: ../../library/sys.rst:543 msgid "minimum integer *e* such that ``10**e`` is a normalized float" msgstr "" -#: ../../library/sys.rst:548 +#: ../../library/sys.rst:546 msgid ":const:`radix`" msgstr ":const:`radix`" -#: ../../library/sys.rst:548 +#: ../../library/sys.rst:546 msgid "FLT_RADIX" msgstr "FLT_RADIX" -#: ../../library/sys.rst:548 +#: ../../library/sys.rst:546 msgid "radix of exponent representation" msgstr "" -#: ../../library/sys.rst:550 +#: ../../library/sys.rst:548 msgid ":const:`rounds`" msgstr ":const:`rounds`" -#: ../../library/sys.rst:550 +#: ../../library/sys.rst:548 msgid "FLT_ROUNDS" msgstr "FLT_ROUNDS" -#: ../../library/sys.rst:550 +#: ../../library/sys.rst:548 msgid "" "integer constant representing the rounding mode used for arithmetic " "operations. This reflects the value of the system FLT_ROUNDS macro at " @@ -870,7 +870,7 @@ msgid "" "explanation of the possible values and their meanings." msgstr "" -#: ../../library/sys.rst:558 +#: ../../library/sys.rst:556 msgid "" "The attribute :attr:`sys.float_info.dig` needs further explanation. If " "``s`` is any string representing a decimal number with at most :attr:`sys." @@ -878,13 +878,13 @@ msgid "" "back again will recover a string representing the same decimal value::" msgstr "" -#: ../../library/sys.rst:571 +#: ../../library/sys.rst:569 msgid "" "But for strings with more than :attr:`sys.float_info.dig` significant " "digits, this isn't always true::" msgstr "" -#: ../../library/sys.rst:580 +#: ../../library/sys.rst:578 msgid "" "A string indicating how the :func:`repr` function behaves for floats. If " "the string has value ``'short'`` then for a finite float ``x``, ``repr(x)`` " @@ -894,7 +894,7 @@ msgid "" "same way as it did in versions of Python prior to 3.1." msgstr "" -#: ../../library/sys.rst:593 +#: ../../library/sys.rst:591 msgid "" "Return the number of memory blocks currently allocated by the interpreter, " "regardless of their size. This function is mainly useful for tracking and " @@ -904,38 +904,38 @@ msgid "" "results." msgstr "" -#: ../../library/sys.rst:600 +#: ../../library/sys.rst:598 msgid "" "If a Python build or implementation cannot reasonably compute this " "information, :func:`getallocatedblocks()` is allowed to return 0 instead." msgstr "" -#: ../../library/sys.rst:608 +#: ../../library/sys.rst:606 msgid "Return the build time API version of Android as an integer." msgstr "" -#: ../../library/sys.rst:611 +#: ../../library/sys.rst:609 msgid ":ref:`Availability `: Android." msgstr ":ref:`適用 `：Android。" -#: ../../library/sys.rst:617 +#: ../../library/sys.rst:615 msgid "" "Return the name of the current default string encoding used by the Unicode " "implementation." msgstr "" -#: ../../library/sys.rst:623 +#: ../../library/sys.rst:621 msgid "" "Return the current value of the flags that are used for :c:func:`dlopen` " "calls. Symbolic names for the flag values can be found in the :mod:`os` " "module (``RTLD_xxx`` constants, e.g. :data:`os.RTLD_LAZY`)." msgstr "" -#: ../../library/sys.rst:628 ../../library/sys.rst:1257 +#: ../../library/sys.rst:626 ../../library/sys.rst:1255 msgid ":ref:`Availability `: Unix." msgstr ":ref:`適用 `：Unix。" -#: ../../library/sys.rst:633 +#: ../../library/sys.rst:631 msgid "" "Get the :term:`filesystem encoding `: " "the encoding used with the :term:`filesystem error handler ` is enabled." msgstr "" -#: ../../library/sys.rst:666 +#: ../../library/sys.rst:664 msgid "" "Get the :term:`filesystem error handler `: the error handler used with the :term:`filesystem encoding " @@ -990,14 +990,14 @@ msgid "" "func:`getfilesystemencoding`." msgstr "" -#: ../../library/sys.rst:684 +#: ../../library/sys.rst:682 msgid "" "Return the reference count of the *object*. The count returned is generally " "one higher than you might expect, because it includes the (temporary) " "reference as an argument to :func:`getrefcount`." msgstr "" -#: ../../library/sys.rst:691 +#: ../../library/sys.rst:689 msgid "" "Return the current value of the recursion limit, the maximum depth of the " "Python interpreter stack. This limit prevents infinite recursion from " @@ -1005,46 +1005,46 @@ msgid "" "func:`setrecursionlimit`." msgstr "" -#: ../../library/sys.rst:699 +#: ../../library/sys.rst:697 msgid "" "Return the size of an object in bytes. The object can be any type of object. " "All built-in objects will return correct results, but this does not have to " "hold true for third-party extensions as it is implementation specific." msgstr "" -#: ../../library/sys.rst:704 +#: ../../library/sys.rst:702 msgid "" "Only the memory consumption directly attributed to the object is accounted " "for, not the memory consumption of objects it refers to." msgstr "" -#: ../../library/sys.rst:707 +#: ../../library/sys.rst:705 msgid "" "If given, *default* will be returned if the object does not provide means to " "retrieve the size. Otherwise a :exc:`TypeError` will be raised." msgstr "" -#: ../../library/sys.rst:710 +#: ../../library/sys.rst:708 msgid "" ":func:`getsizeof` calls the object's ``__sizeof__`` method and adds an " "additional garbage collector overhead if the object is managed by the " "garbage collector." msgstr "" -#: ../../library/sys.rst:714 +#: ../../library/sys.rst:712 msgid "" "See `recursive sizeof recipe `_ " "for an example of using :func:`getsizeof` recursively to find the size of " "containers and all their contents." msgstr "" -#: ../../library/sys.rst:720 +#: ../../library/sys.rst:718 msgid "" "Return the interpreter's \"thread switch interval\"; see :func:" "`setswitchinterval`." msgstr "" -#: ../../library/sys.rst:728 +#: ../../library/sys.rst:726 msgid "" "Return a frame object from the call stack. If optional integer *depth* is " "given, return the frame object that many calls below the top of the stack. " @@ -1053,27 +1053,27 @@ msgid "" "stack." msgstr "" -#: ../../library/sys.rst:733 +#: ../../library/sys.rst:731 msgid "" "Raises an :ref:`auditing event ` ``sys._getframe`` with no " "arguments." msgstr "" -#: ../../library/sys.rst:737 +#: ../../library/sys.rst:735 msgid "" "This function should be used for internal and specialized purposes only. It " "is not guaranteed to exist in all implementations of Python." msgstr "" -#: ../../library/sys.rst:747 +#: ../../library/sys.rst:745 msgid "Get the profiler function as set by :func:`setprofile`." msgstr "" -#: ../../library/sys.rst:756 +#: ../../library/sys.rst:754 msgid "Get the trace function as set by :func:`settrace`." msgstr "" -#: ../../library/sys.rst:760 +#: ../../library/sys.rst:758 msgid "" "The :func:`gettrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -1081,7 +1081,7 @@ msgid "" "thus may not be available in all Python implementations." msgstr "" -#: ../../library/sys.rst:768 +#: ../../library/sys.rst:766 msgid "" "Return a named tuple describing the Windows version currently running. The " "named elements are *major*, *minor*, *build*, *platform*, *service_pack*, " @@ -1093,54 +1093,54 @@ msgid "" "first 5 elements are retrievable by indexing." msgstr "" -#: ../../library/sys.rst:779 +#: ../../library/sys.rst:777 msgid "*platform* will be :const:`2 (VER_PLATFORM_WIN32_NT)`." msgstr "" -#: ../../library/sys.rst:781 +#: ../../library/sys.rst:779 msgid "*product_type* may be one of the following values:" msgstr "" -#: ../../library/sys.rst:784 +#: ../../library/sys.rst:782 msgid "Constant" msgstr "" -#: ../../library/sys.rst:784 +#: ../../library/sys.rst:782 msgid "Meaning" msgstr "" -#: ../../library/sys.rst:786 +#: ../../library/sys.rst:784 msgid ":const:`1 (VER_NT_WORKSTATION)`" msgstr ":const:`1 (VER_NT_WORKSTATION)`" -#: ../../library/sys.rst:786 +#: ../../library/sys.rst:784 msgid "The system is a workstation." msgstr "" -#: ../../library/sys.rst:788 +#: ../../library/sys.rst:786 msgid ":const:`2 (VER_NT_DOMAIN_CONTROLLER)`" msgstr ":const:`2 (VER_NT_DOMAIN_CONTROLLER)`" -#: ../../library/sys.rst:788 +#: ../../library/sys.rst:786 msgid "The system is a domain controller." msgstr "" -#: ../../library/sys.rst:791 +#: ../../library/sys.rst:789 msgid ":const:`3 (VER_NT_SERVER)`" msgstr ":const:`3 (VER_NT_SERVER)`" -#: ../../library/sys.rst:791 +#: ../../library/sys.rst:789 msgid "The system is a server, but not a domain controller." msgstr "" -#: ../../library/sys.rst:795 +#: ../../library/sys.rst:793 msgid "" "This function wraps the Win32 :c:func:`GetVersionEx` function; see the " "Microsoft documentation on :c:func:`OSVERSIONINFOEX` for more information " "about these fields." msgstr "" -#: ../../library/sys.rst:799 +#: ../../library/sys.rst:797 msgid "" "*platform_version* returns the major version, minor version and build number " "of the current operating system, rather than the version that is being " @@ -1148,24 +1148,24 @@ msgid "" "feature detection." msgstr "" -#: ../../library/sys.rst:805 +#: ../../library/sys.rst:803 msgid "" "*platform_version* derives the version from kernel32.dll which can be of a " "different version than the OS version. Please use :mod:`platform` module for " "achieving accurate OS version." msgstr "" -#: ../../library/sys.rst:811 +#: ../../library/sys.rst:809 msgid "" "Changed to a named tuple and added *service_pack_minor*, " "*service_pack_major*, *suite_mask*, and *product_type*." msgstr "" -#: ../../library/sys.rst:815 +#: ../../library/sys.rst:813 msgid "Added *platform_version*" msgstr "新增 *platform_version*" -#: ../../library/sys.rst:821 +#: ../../library/sys.rst:819 msgid "" "Returns an *asyncgen_hooks* object, which is similar to a :class:" "`~collections.namedtuple` of the form `(firstiter, finalizer)`, where " @@ -1175,103 +1175,103 @@ msgid "" "loop." msgstr "" -#: ../../library/sys.rst:828 +#: ../../library/sys.rst:826 msgid "See :pep:`525` for more details." msgstr "更多細節請見 :pep:`525`\\ 。" -#: ../../library/sys.rst:832 ../../library/sys.rst:1451 +#: ../../library/sys.rst:830 ../../library/sys.rst:1449 msgid "" "This function has been added on a provisional basis (see :pep:`411` for " "details.)" msgstr "" -#: ../../library/sys.rst:838 +#: ../../library/sys.rst:836 msgid "" "Get the current coroutine origin tracking depth, as set by :func:" "`set_coroutine_origin_tracking_depth`." msgstr "" -#: ../../library/sys.rst:844 ../../library/sys.rst:1472 +#: ../../library/sys.rst:842 ../../library/sys.rst:1470 msgid "" "This function has been added on a provisional basis (see :pep:`411` for " "details.) Use it only for debugging purposes." msgstr "" -#: ../../library/sys.rst:850 +#: ../../library/sys.rst:848 msgid "" "A :term:`named tuple` giving parameters of the numeric hash implementation. " "For more details about hashing of numeric types, see :ref:`numeric-hash`." msgstr "" -#: ../../library/sys.rst:857 +#: ../../library/sys.rst:855 msgid ":const:`width`" msgstr ":const:`width`" -#: ../../library/sys.rst:857 +#: ../../library/sys.rst:855 msgid "width in bits used for hash values" msgstr "" -#: ../../library/sys.rst:859 +#: ../../library/sys.rst:857 msgid ":const:`modulus`" msgstr ":const:`modulus`" -#: ../../library/sys.rst:859 +#: ../../library/sys.rst:857 msgid "prime modulus P used for numeric hash scheme" msgstr "" -#: ../../library/sys.rst:861 +#: ../../library/sys.rst:859 msgid ":const:`inf`" msgstr ":const:`inf`" -#: ../../library/sys.rst:861 +#: ../../library/sys.rst:859 msgid "hash value returned for a positive infinity" msgstr "" -#: ../../library/sys.rst:863 +#: ../../library/sys.rst:861 msgid ":const:`nan`" msgstr ":const:`nan`" -#: ../../library/sys.rst:863 +#: ../../library/sys.rst:861 msgid "(this attribute is no longer used)" msgstr "" -#: ../../library/sys.rst:865 +#: ../../library/sys.rst:863 msgid ":const:`imag`" msgstr ":const:`imag`" -#: ../../library/sys.rst:865 +#: ../../library/sys.rst:863 msgid "multiplier used for the imaginary part of a complex number" msgstr "" -#: ../../library/sys.rst:868 +#: ../../library/sys.rst:866 msgid ":const:`algorithm`" msgstr ":const:`algorithm`" -#: ../../library/sys.rst:868 +#: ../../library/sys.rst:866 msgid "name of the algorithm for hashing of str, bytes, and memoryview" msgstr "" -#: ../../library/sys.rst:871 +#: ../../library/sys.rst:869 msgid ":const:`hash_bits`" msgstr ":const:`hash_bits`" -#: ../../library/sys.rst:871 +#: ../../library/sys.rst:869 msgid "internal output size of the hash algorithm" msgstr "" -#: ../../library/sys.rst:873 +#: ../../library/sys.rst:871 msgid ":const:`seed_bits`" msgstr ":const:`seed_bits`" -#: ../../library/sys.rst:873 +#: ../../library/sys.rst:871 msgid "size of the seed key of the hash algorithm" msgstr "" -#: ../../library/sys.rst:879 +#: ../../library/sys.rst:877 msgid "Added *algorithm*, *hash_bits* and *seed_bits*" msgstr "新增 *algorithm*\\ 、\\ *hash_bits* 與 *seed_bits*" -#: ../../library/sys.rst:885 +#: ../../library/sys.rst:883 msgid "" "The version number encoded as a single integer. This is guaranteed to " "increase with each version, including proper support for non-production " @@ -1279,7 +1279,7 @@ msgid "" "version 1.5.2, use::" msgstr "" -#: ../../library/sys.rst:896 +#: ../../library/sys.rst:894 msgid "" "This is called ``hexversion`` since it only really looks meaningful when " "viewed as the result of passing it to the built-in :func:`hex` function. " @@ -1287,25 +1287,25 @@ msgid "" "human-friendly encoding of the same information." msgstr "" -#: ../../library/sys.rst:901 +#: ../../library/sys.rst:899 msgid "More details of ``hexversion`` can be found at :ref:`apiabiversion`." msgstr "" -#: ../../library/sys.rst:906 +#: ../../library/sys.rst:904 msgid "" "An object containing information about the implementation of the currently " "running Python interpreter. The following attributes are required to exist " "in all Python implementations." msgstr "" -#: ../../library/sys.rst:910 +#: ../../library/sys.rst:908 msgid "" "*name* is the implementation's identifier, e.g. ``'cpython'``. The actual " "string is defined by the Python implementation, but it is guaranteed to be " "lower case." msgstr "" -#: ../../library/sys.rst:914 +#: ../../library/sys.rst:912 msgid "" "*version* is a named tuple, in the same format as :data:`sys.version_info`. " "It represents the version of the Python *implementation*. This has a " @@ -1317,13 +1317,13 @@ msgid "" "the same value, since it is the reference implementation." msgstr "" -#: ../../library/sys.rst:924 +#: ../../library/sys.rst:922 msgid "" "*hexversion* is the implementation version in hexadecimal format, like :data:" "`sys.hexversion`." msgstr "" -#: ../../library/sys.rst:927 +#: ../../library/sys.rst:925 msgid "" "*cache_tag* is the tag used by the import machinery in the filenames of " "cached modules. By convention, it would be a composite of the " @@ -1332,7 +1332,7 @@ msgid "" "set to ``None``, it indicates that module caching should be disabled." msgstr "" -#: ../../library/sys.rst:934 +#: ../../library/sys.rst:932 msgid "" ":data:`sys.implementation` may contain additional attributes specific to the " "Python implementation. These non-standard attributes must start with an " @@ -1342,45 +1342,45 @@ msgid "" "versions, however.) See :pep:`421` for more information." msgstr "" -#: ../../library/sys.rst:945 +#: ../../library/sys.rst:943 msgid "" "The addition of new required attributes must go through the normal PEP " "process. See :pep:`421` for more information." msgstr "" -#: ../../library/sys.rst:950 +#: ../../library/sys.rst:948 msgid "" "A :term:`named tuple` that holds information about Python's internal " "representation of integers. The attributes are read only." msgstr "" -#: ../../library/sys.rst:956 ../../library/sys.rst:1603 +#: ../../library/sys.rst:954 ../../library/sys.rst:1601 msgid "Attribute" msgstr "屬性" -#: ../../library/sys.rst:956 ../../library/sys.rst:1603 +#: ../../library/sys.rst:954 ../../library/sys.rst:1601 msgid "Explanation" msgstr "解釋" -#: ../../library/sys.rst:958 +#: ../../library/sys.rst:956 msgid ":const:`bits_per_digit`" msgstr ":const:`bits_per_digit`" -#: ../../library/sys.rst:958 +#: ../../library/sys.rst:956 msgid "" "number of bits held in each digit. Python integers are stored internally in " "base ``2**int_info.bits_per_digit``" msgstr "" -#: ../../library/sys.rst:962 +#: ../../library/sys.rst:960 msgid ":const:`sizeof_digit`" msgstr ":const:`sizeof_digit`" -#: ../../library/sys.rst:962 +#: ../../library/sys.rst:960 msgid "size in bytes of the C type used to represent a digit" msgstr "" -#: ../../library/sys.rst:971 +#: ../../library/sys.rst:969 msgid "" "When this attribute exists, its value is automatically called (with no " "arguments) when the interpreter is launched in :ref:`interactive mode `." msgstr "" -#: ../../library/sys.rst:977 +#: ../../library/sys.rst:975 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_interactivehook`` " "with argument ``hook``." msgstr "" -#: ../../library/sys.rst:979 +#: ../../library/sys.rst:977 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_interactivehook`` " "with the hook object as the argument when the hook is called on startup." msgstr "" -#: ../../library/sys.rst:988 +#: ../../library/sys.rst:986 msgid "" "Enter *string* in the table of \"interned\" strings and return the interned " "string -- which is *string* itself or a copy. Interning strings is useful to " @@ -1413,19 +1413,19 @@ msgid "" "attributes have interned keys." msgstr "" -#: ../../library/sys.rst:996 +#: ../../library/sys.rst:994 msgid "" "Interned strings are not immortal; you must keep a reference to the return " "value of :func:`intern` around to benefit from it." msgstr "" -#: ../../library/sys.rst:1002 +#: ../../library/sys.rst:1000 msgid "" "Return :const:`True` if the Python interpreter is :term:`shutting down " "`, :const:`False` otherwise." msgstr "" -#: ../../library/sys.rst:1012 +#: ../../library/sys.rst:1010 msgid "" "These three variables are not always defined; they are set when an exception " "is not handled and the interpreter prints an error message and a stack " @@ -1436,33 +1436,33 @@ msgid "" "information.)" msgstr "" -#: ../../library/sys.rst:1020 +#: ../../library/sys.rst:1018 msgid "" "The meaning of the variables is the same as that of the return values from :" "func:`exc_info` above." msgstr "" -#: ../../library/sys.rst:1026 +#: ../../library/sys.rst:1024 msgid "" "An integer giving the maximum value a variable of type :c:type:`Py_ssize_t` " "can take. It's usually ``2**31 - 1`` on a 32-bit platform and ``2**63 - 1`` " "on a 64-bit platform." msgstr "" -#: ../../library/sys.rst:1033 +#: ../../library/sys.rst:1031 msgid "" "An integer giving the value of the largest Unicode code point, i.e. " "``1114111`` (``0x10FFFF`` in hexadecimal)." msgstr "" -#: ../../library/sys.rst:1036 +#: ../../library/sys.rst:1034 msgid "" "Before :pep:`393`, ``sys.maxunicode`` used to be either ``0xFFFF`` or " "``0x10FFFF``, depending on the configuration option that specified whether " "Unicode characters were stored as UCS-2 or UCS-4." msgstr "" -#: ../../library/sys.rst:1044 +#: ../../library/sys.rst:1042 msgid "" "A list of :term:`meta path finder` objects that have their :meth:`~importlib." "abc.MetaPathFinder.find_spec` methods called to see if one of the objects " @@ -1474,27 +1474,27 @@ msgid "" "module cannot be found." msgstr "" -#: ../../library/sys.rst:1056 +#: ../../library/sys.rst:1054 msgid ":class:`importlib.abc.MetaPathFinder`" msgstr ":class:`importlib.abc.MetaPathFinder`" -#: ../../library/sys.rst:1056 +#: ../../library/sys.rst:1054 msgid "" "The abstract base class defining the interface of finder objects on :data:" "`meta_path`." msgstr "" -#: ../../library/sys.rst:1060 +#: ../../library/sys.rst:1058 msgid ":class:`importlib.machinery.ModuleSpec`" msgstr ":class:`importlib.machinery.ModuleSpec`" -#: ../../library/sys.rst:1059 +#: ../../library/sys.rst:1057 msgid "" "The concrete class which :meth:`~importlib.abc.MetaPathFinder.find_spec` " "should return instances of." msgstr "" -#: ../../library/sys.rst:1065 +#: ../../library/sys.rst:1063 msgid "" ":term:`Module specs ` were introduced in Python 3.4, by :pep:" "`451`. Earlier versions of Python looked for a method called :meth:" @@ -1503,7 +1503,7 @@ msgid "" "MetaPathFinder.find_spec` method." msgstr "" -#: ../../library/sys.rst:1073 +#: ../../library/sys.rst:1071 msgid "" "This is a dictionary that maps module names to modules which have already " "been loaded. This can be manipulated to force reloading of modules and " @@ -1515,24 +1515,24 @@ msgid "" "other threads." msgstr "" -#: ../../library/sys.rst:1085 +#: ../../library/sys.rst:1083 msgid "" "The list of the original command line arguments passed to the Python " "executable." msgstr "" -#: ../../library/sys.rst:1088 +#: ../../library/sys.rst:1086 msgid "See also :data:`sys.argv`." msgstr "另請參閱 :data:`sys.argv`\\ 。" -#: ../../library/sys.rst:1097 +#: ../../library/sys.rst:1095 msgid "" "A list of strings that specifies the search path for modules. Initialized " "from the environment variable :envvar:`PYTHONPATH`, plus an installation-" "dependent default." msgstr "" -#: ../../library/sys.rst:1101 +#: ../../library/sys.rst:1099 msgid "" "As initialized upon program startup, the first item of this list, " "``path[0]``, is the directory containing the script that was used to invoke " @@ -1544,31 +1544,31 @@ msgid "" "`PYTHONPATH`." msgstr "" -#: ../../library/sys.rst:1109 +#: ../../library/sys.rst:1107 msgid "" "A program is free to modify this list for its own purposes. Only strings " "and bytes should be added to :data:`sys.path`; all other data types are " "ignored during import." msgstr "" -#: ../../library/sys.rst:1115 +#: ../../library/sys.rst:1113 msgid "" "Module :mod:`site` This describes how to use .pth files to extend :data:`sys." "path`." msgstr "" -#: ../../library/sys.rst:1121 +#: ../../library/sys.rst:1119 msgid "" "A list of callables that take a path argument to try to create a :term:" "`finder` for the path. If a finder can be created, it is to be returned by " "the callable, else raise :exc:`ImportError`." msgstr "" -#: ../../library/sys.rst:1125 ../../library/sys.rst:1136 +#: ../../library/sys.rst:1123 ../../library/sys.rst:1134 msgid "Originally specified in :pep:`302`." msgstr "" -#: ../../library/sys.rst:1130 +#: ../../library/sys.rst:1128 msgid "" "A dictionary acting as a cache for :term:`finder` objects. The keys are " "paths that have been passed to :data:`sys.path_hooks` and the values are the " @@ -1576,19 +1576,19 @@ msgid "" "is found on :data:`sys.path_hooks` then ``None`` is stored." msgstr "" -#: ../../library/sys.rst:1138 +#: ../../library/sys.rst:1136 msgid "" "``None`` is stored instead of :class:`imp.NullImporter` when no finder is " "found." msgstr "" -#: ../../library/sys.rst:1145 +#: ../../library/sys.rst:1143 msgid "" "This string contains a platform identifier that can be used to append " "platform-specific components to :data:`sys.path`, for instance." msgstr "" -#: ../../library/sys.rst:1148 +#: ../../library/sys.rst:1146 msgid "" "For Unix systems, except on Linux and AIX, this is the lowercased OS name as " "returned by ``uname -s`` with the first part of the version as returned by " @@ -1597,59 +1597,59 @@ msgid "" "version, it is therefore recommended to use the following idiom::" msgstr "" -#: ../../library/sys.rst:1161 +#: ../../library/sys.rst:1159 msgid "For other systems, the values are:" msgstr "" -#: ../../library/sys.rst:1164 +#: ../../library/sys.rst:1162 msgid "System" msgstr "" -#: ../../library/sys.rst:1164 +#: ../../library/sys.rst:1162 msgid "``platform`` value" msgstr "" -#: ../../library/sys.rst:1166 +#: ../../library/sys.rst:1164 msgid "AIX" msgstr "AIX" -#: ../../library/sys.rst:1166 +#: ../../library/sys.rst:1164 msgid "``'aix'``" msgstr "``'aix'``" -#: ../../library/sys.rst:1167 +#: ../../library/sys.rst:1165 msgid "Linux" msgstr "Linux" -#: ../../library/sys.rst:1167 +#: ../../library/sys.rst:1165 msgid "``'linux'``" msgstr "``'linux'``" -#: ../../library/sys.rst:1168 +#: ../../library/sys.rst:1166 msgid "Windows" msgstr "Windows" -#: ../../library/sys.rst:1168 +#: ../../library/sys.rst:1166 msgid "``'win32'``" msgstr "``'win32'``" -#: ../../library/sys.rst:1169 +#: ../../library/sys.rst:1167 msgid "Windows/Cygwin" msgstr "Windows/Cygwin" -#: ../../library/sys.rst:1169 +#: ../../library/sys.rst:1167 msgid "``'cygwin'``" msgstr "``'cygwin'``" -#: ../../library/sys.rst:1170 +#: ../../library/sys.rst:1168 msgid "macOS" msgstr "macOS" -#: ../../library/sys.rst:1170 +#: ../../library/sys.rst:1168 msgid "``'darwin'``" msgstr "``'darwin'``" -#: ../../library/sys.rst:1173 +#: ../../library/sys.rst:1171 msgid "" "On Linux, :attr:`sys.platform` doesn't contain the major version anymore. It " "is always ``'linux'``, instead of ``'linux2'`` or ``'linux3'``. Since older " @@ -1657,7 +1657,7 @@ msgid "" "the ``startswith`` idiom presented above." msgstr "" -#: ../../library/sys.rst:1179 +#: ../../library/sys.rst:1177 msgid "" "On AIX, :attr:`sys.platform` doesn't contain the major version anymore. It " "is always ``'aix'``, instead of ``'aix5'`` or ``'aix7'``. Since older " @@ -1665,57 +1665,57 @@ msgid "" "the ``startswith`` idiom presented above." msgstr "" -#: ../../library/sys.rst:1187 +#: ../../library/sys.rst:1185 msgid "" ":attr:`os.name` has a coarser granularity. :func:`os.uname` gives system-" "dependent version information." msgstr "" -#: ../../library/sys.rst:1190 +#: ../../library/sys.rst:1188 msgid "" "The :mod:`platform` module provides detailed checks for the system's " "identity." msgstr "" -#: ../../library/sys.rst:1196 +#: ../../library/sys.rst:1194 msgid "" "Name of the platform-specific library directory. It is used to build the " "path of standard library and the paths of installed extension modules." msgstr "" -#: ../../library/sys.rst:1199 +#: ../../library/sys.rst:1197 msgid "" "It is equal to ``\"lib\"`` on most platforms. On Fedora and SuSE, it is " "equal to ``\"lib64\"`` on 64-bit platforms which gives the following ``sys." "path`` paths (where ``X.Y`` is the Python ``major.minor`` version):" msgstr "" -#: ../../library/sys.rst:1203 +#: ../../library/sys.rst:1201 msgid "" "``/usr/lib64/pythonX.Y/``: Standard library (like ``os.py`` of the :mod:`os` " "module)" msgstr "" -#: ../../library/sys.rst:1205 +#: ../../library/sys.rst:1203 msgid "" "``/usr/lib64/pythonX.Y/lib-dynload/``: C extension modules of the standard " "library (like the :mod:`errno` module, the exact filename is platform " "specific)" msgstr "" -#: ../../library/sys.rst:1208 +#: ../../library/sys.rst:1206 msgid "" "``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, not :data:`sys." "platlibdir`): Third-party modules" msgstr "" -#: ../../library/sys.rst:1210 +#: ../../library/sys.rst:1208 msgid "" "``/usr/lib64/pythonX.Y/site-packages/``: C extension modules of third-party " "packages" msgstr "" -#: ../../library/sys.rst:1218 +#: ../../library/sys.rst:1216 msgid "" "A string giving the site-specific directory prefix where the platform " "independent Python files are installed; on Unix, the default is ``'/usr/" @@ -1724,14 +1724,14 @@ msgid "" "paths." msgstr "" -#: ../../library/sys.rst:1224 +#: ../../library/sys.rst:1222 msgid "" "If a :ref:`virtual environment ` is in effect, this value will be " "changed in ``site.py`` to point to the virtual environment. The value for " "the Python installation will still be available, via :data:`base_prefix`." msgstr "" -#: ../../library/sys.rst:1239 +#: ../../library/sys.rst:1237 msgid "" "Strings specifying the primary and secondary prompt of the interpreter. " "These are only defined if the interpreter is in interactive mode. Their " @@ -1741,7 +1741,7 @@ msgid "" "used to implement a dynamic prompt." msgstr "" -#: ../../library/sys.rst:1249 +#: ../../library/sys.rst:1247 msgid "" "Set the flags used by the interpreter for :c:func:`dlopen` calls, such as " "when the interpreter loads extension modules. Among other things, this will " @@ -1752,7 +1752,7 @@ msgid "" "data:`os.RTLD_LAZY`)." msgstr "" -#: ../../library/sys.rst:1265 +#: ../../library/sys.rst:1263 msgid "" "Set the system's profile function, which allows you to implement a Python " "source code profiler in Python. See chapter :ref:`profile` for more " @@ -1767,7 +1767,7 @@ msgid "" "in the profile function will cause itself unset." msgstr "" -#: ../../library/sys.rst:1276 +#: ../../library/sys.rst:1274 msgid "" "Profile functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -1775,71 +1775,71 @@ msgid "" "depends on the event type." msgstr "" -#: ../../library/sys.rst:1281 +#: ../../library/sys.rst:1279 msgid "" "Raises an :ref:`auditing event ` ``sys.setprofile`` with no " "arguments." msgstr "" -#: ../../library/sys.rst:1283 ../../library/sys.rst:1364 +#: ../../library/sys.rst:1281 ../../library/sys.rst:1362 msgid "The events have the following meaning:" msgstr "" -#: ../../library/sys.rst:1287 ../../library/sys.rst:1369 +#: ../../library/sys.rst:1285 ../../library/sys.rst:1367 msgid "``'call'``" msgstr "``'call'``" -#: ../../library/sys.rst:1286 +#: ../../library/sys.rst:1284 msgid "" "A function is called (or some other code block entered). The profile " "function is called; *arg* is ``None``." msgstr "" -#: ../../library/sys.rst:1292 ../../library/sys.rst:1384 +#: ../../library/sys.rst:1290 ../../library/sys.rst:1382 msgid "``'return'``" msgstr "``'return'``" -#: ../../library/sys.rst:1290 +#: ../../library/sys.rst:1288 msgid "" "A function (or other code block) is about to return. The profile function " "is called; *arg* is the value that will be returned, or ``None`` if the " "event is caused by an exception being raised." msgstr "" -#: ../../library/sys.rst:1296 +#: ../../library/sys.rst:1294 msgid "``'c_call'``" msgstr "``'c_call'``" -#: ../../library/sys.rst:1295 +#: ../../library/sys.rst:1293 msgid "" "A C function is about to be called. This may be an extension function or a " "built-in. *arg* is the C function object." msgstr "" -#: ../../library/sys.rst:1299 +#: ../../library/sys.rst:1297 msgid "``'c_return'``" msgstr "``'c_return'``" -#: ../../library/sys.rst:1299 +#: ../../library/sys.rst:1297 msgid "A C function has returned. *arg* is the C function object." msgstr "" -#: ../../library/sys.rst:1301 +#: ../../library/sys.rst:1299 msgid "``'c_exception'``" msgstr "``'c_exception'``" -#: ../../library/sys.rst:1302 +#: ../../library/sys.rst:1300 msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" -#: ../../library/sys.rst:1306 +#: ../../library/sys.rst:1304 msgid "" "Set the maximum depth of the Python interpreter stack to *limit*. This " "limit prevents infinite recursion from causing an overflow of the C stack " "and crashing Python." msgstr "" -#: ../../library/sys.rst:1310 +#: ../../library/sys.rst:1308 msgid "" "The highest possible limit is platform-dependent. A user may need to set " "the limit higher when they have a program that requires deep recursion and a " @@ -1847,19 +1847,19 @@ msgid "" "because a too-high limit can lead to a crash." msgstr "" -#: ../../library/sys.rst:1315 +#: ../../library/sys.rst:1313 msgid "" "If the new limit is too low at the current recursion depth, a :exc:" "`RecursionError` exception is raised." msgstr "" -#: ../../library/sys.rst:1318 +#: ../../library/sys.rst:1316 msgid "" "A :exc:`RecursionError` exception is now raised if the new limit is too low " "at the current recursion depth." msgstr "" -#: ../../library/sys.rst:1325 +#: ../../library/sys.rst:1323 msgid "" "Set the interpreter's thread switch interval (in seconds). This floating-" "point value determines the ideal duration of the \"timeslices\" allocated to " @@ -1870,7 +1870,7 @@ msgid "" "scheduler." msgstr "" -#: ../../library/sys.rst:1342 +#: ../../library/sys.rst:1340 msgid "" "Set the system's trace function, which allows you to implement a Python " "source code debugger in Python. The function is thread-specific; for a " @@ -1879,7 +1879,7 @@ msgid "" "`threading.settrace`." msgstr "" -#: ../../library/sys.rst:1347 +#: ../../library/sys.rst:1345 msgid "" "Trace functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -1887,7 +1887,7 @@ msgid "" "the event type." msgstr "" -#: ../../library/sys.rst:1352 +#: ../../library/sys.rst:1350 msgid "" "The trace function is invoked (with *event* set to ``'call'``) whenever a " "new local scope is entered; it should return a reference to a local trace " @@ -1895,31 +1895,31 @@ msgid "" "traced." msgstr "" -#: ../../library/sys.rst:1357 +#: ../../library/sys.rst:1355 msgid "" "The local trace function should return a reference to itself (or to another " "function for further tracing in that scope), or ``None`` to turn off tracing " "in that scope." msgstr "" -#: ../../library/sys.rst:1361 +#: ../../library/sys.rst:1359 msgid "" "If there is any error occurred in the trace function, it will be unset, just " "like ``settrace(None)`` is called." msgstr "" -#: ../../library/sys.rst:1367 +#: ../../library/sys.rst:1365 msgid "" "A function is called (or some other code block entered). The global trace " "function is called; *arg* is ``None``; the return value specifies the local " "trace function." msgstr "" -#: ../../library/sys.rst:1378 +#: ../../library/sys.rst:1376 msgid "``'line'``" msgstr "``'line'``" -#: ../../library/sys.rst:1372 +#: ../../library/sys.rst:1370 msgid "" "The interpreter is about to execute a new line of code or re-execute the " "condition of a loop. The local trace function is called; *arg* is ``None``; " @@ -1929,7 +1929,7 @@ msgid "" "const:`False` on that frame." msgstr "" -#: ../../library/sys.rst:1381 +#: ../../library/sys.rst:1379 msgid "" "A function (or other code block) is about to return. The local trace " "function is called; *arg* is the value that will be returned, or ``None`` if " @@ -1937,22 +1937,22 @@ msgid "" "return value is ignored." msgstr "" -#: ../../library/sys.rst:1389 +#: ../../library/sys.rst:1387 msgid "``'exception'``" msgstr "``'exception'``" -#: ../../library/sys.rst:1387 +#: ../../library/sys.rst:1385 msgid "" "An exception has occurred. The local trace function is called; *arg* is a " "tuple ``(exception, value, traceback)``; the return value specifies the new " "local trace function." msgstr "" -#: ../../library/sys.rst:1397 +#: ../../library/sys.rst:1395 msgid "``'opcode'``" msgstr "``'opcode'``" -#: ../../library/sys.rst:1392 +#: ../../library/sys.rst:1390 msgid "" "The interpreter is about to execute a new opcode (see :mod:`dis` for opcode " "details). The local trace function is called; *arg* is ``None``; the return " @@ -1961,13 +1961,13 @@ msgid "" "`f_trace_opcodes` to :const:`True` on the frame." msgstr "" -#: ../../library/sys.rst:1399 +#: ../../library/sys.rst:1397 msgid "" "Note that as an exception is propagated down the chain of callers, an " "``'exception'`` event is generated at each level." msgstr "" -#: ../../library/sys.rst:1402 +#: ../../library/sys.rst:1400 msgid "" "For more fine-grained usage, it's possible to set a trace function by " "assigning ``frame.f_trace = tracefunc`` explicitly, rather than relying on " @@ -1981,17 +1981,17 @@ msgid "" "on each frame)." msgstr "" -#: ../../library/sys.rst:1413 +#: ../../library/sys.rst:1411 msgid "For more information on code and frame objects, refer to :ref:`types`." msgstr "" -#: ../../library/sys.rst:1415 +#: ../../library/sys.rst:1413 msgid "" "Raises an :ref:`auditing event ` ``sys.settrace`` with no " "arguments." msgstr "" -#: ../../library/sys.rst:1419 +#: ../../library/sys.rst:1417 msgid "" "The :func:`settrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -1999,13 +1999,13 @@ msgid "" "thus may not be available in all Python implementations." msgstr "" -#: ../../library/sys.rst:1426 +#: ../../library/sys.rst:1424 msgid "" "``'opcode'`` event type added; :attr:`f_trace_lines` and :attr:" "`f_trace_opcodes` attributes added to frames" msgstr "" -#: ../../library/sys.rst:1431 +#: ../../library/sys.rst:1429 msgid "" "Accepts two optional keyword arguments which are callables that accept an :" "term:`asynchronous generator iterator` as an argument. The *firstiter* " @@ -2014,32 +2014,32 @@ msgid "" "about to be garbage collected." msgstr "" -#: ../../library/sys.rst:1437 +#: ../../library/sys.rst:1435 msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_firstiter`` with no arguments." msgstr "" -#: ../../library/sys.rst:1439 +#: ../../library/sys.rst:1437 msgid "" "Raises an :ref:`auditing event ` ``sys." "set_asyncgen_hooks_finalizer`` with no arguments." msgstr "" -#: ../../library/sys.rst:1441 +#: ../../library/sys.rst:1439 msgid "" "Two auditing events are raised because the underlying API consists of two " "calls, each of which must raise its own event." msgstr "" -#: ../../library/sys.rst:1444 +#: ../../library/sys.rst:1442 msgid "" "See :pep:`525` for more details, and for a reference example of a " "*finalizer* method see the implementation of ``asyncio.Loop." "shutdown_asyncgens`` in :source:`Lib/asyncio/base_events.py`" msgstr "" -#: ../../library/sys.rst:1456 +#: ../../library/sys.rst:1454 msgid "" "Allows enabling or disabling coroutine origin tracking. When enabled, the " "``cr_origin`` attribute on coroutine objects will contain a tuple of " @@ -2048,74 +2048,74 @@ msgid "" "disabled, ``cr_origin`` will be None." msgstr "" -#: ../../library/sys.rst:1463 +#: ../../library/sys.rst:1461 msgid "" "To enable, pass a *depth* value greater than zero; this sets the number of " "frames whose information will be captured. To disable, pass set *depth* to " "zero." msgstr "" -#: ../../library/sys.rst:1467 +#: ../../library/sys.rst:1465 msgid "This setting is thread-specific." msgstr "" -#: ../../library/sys.rst:1477 +#: ../../library/sys.rst:1475 msgid "" "Changes the :term:`filesystem encoding and error handler` to 'mbcs' and " "'replace' respectively, for consistency with versions of Python prior to 3.6." msgstr "" -#: ../../library/sys.rst:1481 +#: ../../library/sys.rst:1479 msgid "" "This is equivalent to defining the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` " "environment variable before launching Python." msgstr "" -#: ../../library/sys.rst:1484 +#: ../../library/sys.rst:1482 msgid "" "See also :func:`sys.getfilesystemencoding` and :func:`sys." "getfilesystemencodeerrors`." msgstr "" -#: ../../library/sys.rst:1489 +#: ../../library/sys.rst:1487 msgid "See :pep:`529` for more details." msgstr "更多細節請見 :pep:`529`\\ 。" -#: ../../library/sys.rst:1496 +#: ../../library/sys.rst:1494 msgid "" ":term:`File objects ` used by the interpreter for standard " "input, output and errors:" msgstr "" -#: ../../library/sys.rst:1499 +#: ../../library/sys.rst:1497 msgid "" "``stdin`` is used for all interactive input (including calls to :func:" "`input`);" msgstr "" -#: ../../library/sys.rst:1501 +#: ../../library/sys.rst:1499 msgid "" "``stdout`` is used for the output of :func:`print` and :term:`expression` " "statements and for the prompts of :func:`input`;" msgstr "" -#: ../../library/sys.rst:1503 +#: ../../library/sys.rst:1501 msgid "The interpreter's own prompts and its error messages go to ``stderr``." msgstr "" -#: ../../library/sys.rst:1505 +#: ../../library/sys.rst:1503 msgid "" "These streams are regular :term:`text files ` like those returned " "by the :func:`open` function. Their parameters are chosen as follows:" msgstr "" -#: ../../library/sys.rst:1509 +#: ../../library/sys.rst:1507 msgid "" "The encoding and error handling are is initialized from :c:member:`PyConfig." "stdio_encoding` and :c:member:`PyConfig.stdio_errors`." msgstr "" -#: ../../library/sys.rst:1512 +#: ../../library/sys.rst:1510 msgid "" "On Windows, UTF-8 is used for the console device. Non-character devices " "such as disk files and pipes use the system locale encoding (i.e. the ANSI " @@ -2126,14 +2126,14 @@ msgid "" "initially attached to a console." msgstr "" -#: ../../library/sys.rst:1521 +#: ../../library/sys.rst:1519 msgid "" "The special behaviour of the console can be overridden by setting the " "environment variable PYTHONLEGACYWINDOWSSTDIO before starting Python. In " "that case, the console codepages are used as for any other character device." msgstr "" -#: ../../library/sys.rst:1526 +#: ../../library/sys.rst:1524 msgid "" "Under all platforms, you can override the character encoding by setting the :" "envvar:`PYTHONIOENCODING` environment variable before starting Python or by " @@ -2142,7 +2142,7 @@ msgid "" "only applies when :envvar:`PYTHONLEGACYWINDOWSSTDIO` is also set." msgstr "" -#: ../../library/sys.rst:1533 +#: ../../library/sys.rst:1531 msgid "" "When interactive, the ``stdout`` stream is line-buffered. Otherwise, it is " "block-buffered like regular text files. The ``stderr`` stream is line-" @@ -2151,19 +2151,19 @@ msgid "" "`PYTHONUNBUFFERED` environment variable." msgstr "" -#: ../../library/sys.rst:1539 +#: ../../library/sys.rst:1537 msgid "" "Non-interactive ``stderr`` is now line-buffered instead of fully buffered." msgstr "" -#: ../../library/sys.rst:1545 +#: ../../library/sys.rst:1543 msgid "" "To write or read binary data from/to the standard streams, use the " "underlying binary :data:`~io.TextIOBase.buffer` object. For example, to " "write bytes to :data:`stdout`, use ``sys.stdout.buffer.write(b'abc')``." msgstr "" -#: ../../library/sys.rst:1549 +#: ../../library/sys.rst:1547 msgid "" "However, if you are writing a library (and do not control in which context " "its code will be executed), be aware that the standard streams may be " @@ -2171,7 +2171,7 @@ msgid "" "support the :attr:`~io.BufferedIOBase.buffer` attribute." msgstr "" -#: ../../library/sys.rst:1559 +#: ../../library/sys.rst:1557 msgid "" "These objects contain the original values of ``stdin``, ``stderr`` and " "``stdout`` at the start of the program. They are used during finalization, " @@ -2179,7 +2179,7 @@ msgid "" "``sys.std*`` object has been redirected." msgstr "" -#: ../../library/sys.rst:1564 +#: ../../library/sys.rst:1562 msgid "" "It can also be used to restore the actual files to known working file " "objects in case they have been overwritten with a broken object. However, " @@ -2187,7 +2187,7 @@ msgid "" "before replacing it, and restore the saved object." msgstr "" -#: ../../library/sys.rst:1570 +#: ../../library/sys.rst:1568 msgid "" "Under some conditions ``stdin``, ``stdout`` and ``stderr`` as well as the " "original values ``__stdin__``, ``__stdout__`` and ``__stderr__`` can be " @@ -2195,12 +2195,12 @@ msgid "" "to a console and Python apps started with :program:`pythonw`." msgstr "" -#: ../../library/sys.rst:1578 +#: ../../library/sys.rst:1576 msgid "" "A frozenset of strings containing the names of standard library modules." msgstr "" -#: ../../library/sys.rst:1580 +#: ../../library/sys.rst:1578 msgid "" "It is the same on all platforms. Modules which are not available on some " "platforms and modules disabled at Python build are also listed. All module " @@ -2208,7 +2208,7 @@ msgid "" "modules are excluded." msgstr "" -#: ../../library/sys.rst:1585 +#: ../../library/sys.rst:1583 msgid "" "For packages, only the main package is listed: sub-packages and sub-modules " "are not listed. For example, the ``email`` package is listed, but the " @@ -2216,66 +2216,66 @@ msgid "" "listed." msgstr "" -#: ../../library/sys.rst:1590 +#: ../../library/sys.rst:1588 msgid "See also the :attr:`sys.builtin_module_names` list." msgstr "另請參閱 :attr:`sys.builtin_module_names` 清單。" -#: ../../library/sys.rst:1597 +#: ../../library/sys.rst:1595 msgid "" "A :term:`named tuple` holding information about the thread implementation." msgstr "" -#: ../../library/sys.rst:1605 +#: ../../library/sys.rst:1603 msgid ":const:`name`" msgstr ":const:`name`" -#: ../../library/sys.rst:1605 +#: ../../library/sys.rst:1603 msgid "Name of the thread implementation:" msgstr "" -#: ../../library/sys.rst:1607 +#: ../../library/sys.rst:1605 msgid "``'nt'``: Windows threads" msgstr "" -#: ../../library/sys.rst:1608 +#: ../../library/sys.rst:1606 msgid "``'pthread'``: POSIX threads" msgstr "" -#: ../../library/sys.rst:1609 +#: ../../library/sys.rst:1607 msgid "``'solaris'``: Solaris threads" msgstr "" -#: ../../library/sys.rst:1611 +#: ../../library/sys.rst:1609 msgid ":const:`lock`" msgstr ":const:`lock`" -#: ../../library/sys.rst:1611 +#: ../../library/sys.rst:1609 msgid "Name of the lock implementation:" msgstr "" -#: ../../library/sys.rst:1613 +#: ../../library/sys.rst:1611 msgid "``'semaphore'``: a lock uses a semaphore" msgstr "" -#: ../../library/sys.rst:1614 +#: ../../library/sys.rst:1612 msgid "``'mutex+cond'``: a lock uses a mutex and a condition variable" msgstr "" -#: ../../library/sys.rst:1616 +#: ../../library/sys.rst:1614 msgid "``None`` if this information is unknown" msgstr "" -#: ../../library/sys.rst:1618 +#: ../../library/sys.rst:1616 msgid ":const:`version`" msgstr ":const:`version`" -#: ../../library/sys.rst:1618 +#: ../../library/sys.rst:1616 msgid "" "Name and version of the thread library. It is a string, or ``None`` if this " "information is unknown." msgstr "" -#: ../../library/sys.rst:1627 +#: ../../library/sys.rst:1625 msgid "" "When this variable is set to an integer value, it determines the maximum " "number of levels of traceback information printed when an unhandled " @@ -2284,78 +2284,78 @@ msgid "" "are printed." msgstr "" -#: ../../library/sys.rst:1635 +#: ../../library/sys.rst:1633 msgid "Handle an unraisable exception." msgstr "" -#: ../../library/sys.rst:1637 +#: ../../library/sys.rst:1635 msgid "" "Called when an exception has occurred but there is no way for Python to " "handle it. For example, when a destructor raises an exception or during " "garbage collection (:func:`gc.collect`)." msgstr "" -#: ../../library/sys.rst:1641 +#: ../../library/sys.rst:1639 msgid "The *unraisable* argument has the following attributes:" msgstr "" -#: ../../library/sys.rst:1643 +#: ../../library/sys.rst:1641 msgid "*exc_type*: Exception type." msgstr "" -#: ../../library/sys.rst:1644 +#: ../../library/sys.rst:1642 msgid "*exc_value*: Exception value, can be ``None``." msgstr "" -#: ../../library/sys.rst:1645 +#: ../../library/sys.rst:1643 msgid "*exc_traceback*: Exception traceback, can be ``None``." msgstr "" -#: ../../library/sys.rst:1646 +#: ../../library/sys.rst:1644 msgid "*err_msg*: Error message, can be ``None``." msgstr "" -#: ../../library/sys.rst:1647 +#: ../../library/sys.rst:1645 msgid "*object*: Object causing the exception, can be ``None``." msgstr "" -#: ../../library/sys.rst:1649 +#: ../../library/sys.rst:1647 msgid "" "The default hook formats *err_msg* and *object* as: ``f'{err_msg}: {object!" "r}'``; use \"Exception ignored in\" error message if *err_msg* is ``None``." msgstr "" -#: ../../library/sys.rst:1653 +#: ../../library/sys.rst:1651 msgid "" ":func:`sys.unraisablehook` can be overridden to control how unraisable " "exceptions are handled." msgstr "" -#: ../../library/sys.rst:1656 +#: ../../library/sys.rst:1654 msgid "" "Storing *exc_value* using a custom hook can create a reference cycle. It " "should be cleared explicitly to break the reference cycle when the exception " "is no longer needed." msgstr "" -#: ../../library/sys.rst:1660 +#: ../../library/sys.rst:1658 msgid "" "Storing *object* using a custom hook can resurrect it if it is set to an " "object which is being finalized. Avoid storing *object* after the custom " "hook completes to avoid resurrecting objects." msgstr "" -#: ../../library/sys.rst:1664 +#: ../../library/sys.rst:1662 msgid "See also :func:`excepthook` which handles uncaught exceptions." msgstr "" -#: ../../library/sys.rst:1666 +#: ../../library/sys.rst:1664 msgid "" "Raises an :ref:`auditing event ` ``sys.unraisablehook`` with " "arguments ``hook``, ``unraisable``." msgstr "" -#: ../../library/sys.rst:1668 +#: ../../library/sys.rst:1666 msgid "" "Raise an auditing event ``sys.unraisablehook`` with arguments ``hook``, " "``unraisable`` when an exception that cannot be handled occurs. The " @@ -2363,7 +2363,7 @@ msgid "" "hook has been set, ``hook`` may be ``None``." msgstr "" -#: ../../library/sys.rst:1677 +#: ../../library/sys.rst:1675 msgid "" "A string containing the version number of the Python interpreter plus " "additional information on the build number and compiler used. This string " @@ -2372,13 +2372,13 @@ msgid "" "functions provided by the :mod:`platform` module." msgstr "" -#: ../../library/sys.rst:1686 +#: ../../library/sys.rst:1684 msgid "" "The C API version for this interpreter. Programmers may find this useful " "when debugging version conflicts between Python and extension modules." msgstr "" -#: ../../library/sys.rst:1692 +#: ../../library/sys.rst:1690 msgid "" "A tuple containing the five components of the version number: *major*, " "*minor*, *micro*, *releaselevel*, and *serial*. All values except " @@ -2389,18 +2389,18 @@ msgid "" "version_info.major`` and so on." msgstr "" -#: ../../library/sys.rst:1700 +#: ../../library/sys.rst:1698 msgid "Added named component attributes." msgstr "" -#: ../../library/sys.rst:1705 +#: ../../library/sys.rst:1703 msgid "" "This is an implementation detail of the warnings framework; do not modify " "this value. Refer to the :mod:`warnings` module for more information on the " "warnings framework." msgstr "" -#: ../../library/sys.rst:1712 +#: ../../library/sys.rst:1710 msgid "" "The version number used to form registry keys on Windows platforms. This is " "stored as string resource 1000 in the Python DLL. The value is normally the " @@ -2409,25 +2409,25 @@ msgid "" "on the registry keys used by Python." msgstr "" -#: ../../library/sys.rst:1723 +#: ../../library/sys.rst:1721 msgid "" "A dictionary of the various implementation-specific flags passed through " "the :option:`-X` command-line option. Option names are either mapped to " "their values, if given explicitly, or to :const:`True`. Example:" msgstr "" -#: ../../library/sys.rst:1739 +#: ../../library/sys.rst:1737 msgid "" "This is a CPython-specific way of accessing options passed through :option:`-" "X`. Other implementations may export them through other means, or not at " "all." msgstr "" -#: ../../library/sys.rst:1747 +#: ../../library/sys.rst:1745 msgid "Citations" msgstr "" -#: ../../library/sys.rst:1748 +#: ../../library/sys.rst:1746 msgid "" "ISO/IEC 9899:1999. \"Programming languages -- C.\" A public draft of this " "standard is available at http://www.open-std.org/jtc1/sc22/wg14/www/docs/"