diff --git a/c-api/iter.po b/c-api/iter.po index 34425ae206..24429a47bf 100644 --- a/c-api/iter.po +++ b/c-api/iter.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: 2021-11-23 00:09+0000\n" "PO-Revision-Date: 2015-12-09 17:51+0000\n" "Last-Translator: Liang-Bo Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -28,8 +28,8 @@ msgstr "" #: ../../c-api/iter.rst:12 msgid "" -"Return non-zero if the object *o* supports the iterator protocol, and ``0`` " -"otherwise. This function always succeeds." +"Return non-zero if the object *o* can be safely passed to :c:func:" +"`PyIter_Next`, and ``0`` otherwise. This function always succeeds." msgstr "" #: ../../c-api/iter.rst:17 @@ -40,38 +40,39 @@ msgstr "" #: ../../c-api/iter.rst:24 msgid "" -"Return the next value from the iteration *o*. The object must be an " -"iterator (it is up to the caller to check this). If there are no remaining " -"values, returns ``NULL`` with no exception set. If an error occurs while " -"retrieving the item, returns ``NULL`` and passes along the exception." +"Return the next value from the iterator *o*. The object must be an iterator " +"according to :c:func:`PyIter_Check` (it is up to the caller to check this). " +"If there are no remaining values, returns ``NULL`` with no exception set. If " +"an error occurs while retrieving the item, returns ``NULL`` and passes along " +"the exception." msgstr "" -#: ../../c-api/iter.rst:29 +#: ../../c-api/iter.rst:30 msgid "" "To write a loop which iterates over an iterator, the C code should look " "something like this::" msgstr "" -#: ../../c-api/iter.rst:58 +#: ../../c-api/iter.rst:59 msgid "" "The enum value used to represent different results of :c:func:`PyIter_Send`." msgstr "" -#: ../../c-api/iter.rst:65 +#: ../../c-api/iter.rst:66 msgid "Sends the *arg* value into the iterator *iter*. Returns:" msgstr "" -#: ../../c-api/iter.rst:67 +#: ../../c-api/iter.rst:68 msgid "" "``PYGEN_RETURN`` if iterator returns. Return value is returned via *presult*." msgstr "" -#: ../../c-api/iter.rst:68 +#: ../../c-api/iter.rst:69 msgid "" "``PYGEN_NEXT`` if iterator yields. Yielded value is returned via *presult*." msgstr "" -#: ../../c-api/iter.rst:69 +#: ../../c-api/iter.rst:70 msgid "" "``PYGEN_ERROR`` if iterator has raised and exception. *presult* is set to " "``NULL``." diff --git a/c-api/typeobj.po b/c-api/typeobj.po index 177b883cd9..378947e7e7 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: 2021-10-29 00:08+0000\n" +"POT-Creation-Date: 2021-11-23 00:09+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-" @@ -2369,9 +2369,9 @@ msgstr "" #: ../../c-api/typeobj.rst:1523 msgid "" -"An optional pointer to a function that returns an iterator for the object. " -"Its presence normally signals that the instances of this type are iterable " -"(although sequences may be iterable without this function)." +"An optional pointer to a function that returns an :term:`iterator` for the " +"object. Its presence normally signals that the instances of this type are :" +"term:`iterable` (although sequences may be iterable without this function)." msgstr "" #: ../../c-api/typeobj.rst:1527 @@ -2380,8 +2380,8 @@ msgstr "" #: ../../c-api/typeobj.rst:1538 msgid "" -"An optional pointer to a function that returns the next item in an iterator. " -"The signature is::" +"An optional pointer to a function that returns the next item in an :term:" +"`iterator`. The signature is::" msgstr "" #: ../../c-api/typeobj.rst:1543 @@ -3267,8 +3267,8 @@ msgstr "" #: ../../c-api/typeobj.rst:2431 msgid "" -"The returned object must be an iterator, i.e. :c:func:`PyIter_Check` must " -"return ``1`` for it." +"The returned object must be an :term:`iterator`, i.e. :c:func:`PyIter_Check` " +"must return ``1`` for it." msgstr "" #: ../../c-api/typeobj.rst:2434 diff --git a/glossary.po b/glossary.po index b4fe0df39e..2367ff0d77 100644 --- a/glossary.po +++ b/glossary.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-11-07 00:09+0000\n" +"POT-Creation-Date: 2021-11-23 00:09+0000\n" "PO-Revision-Date: 2021-11-15 11:05+0800\n" "Last-Translator: Matt Wang \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1478,11 +1478,17 @@ msgstr "" msgid "More information can be found in :ref:`typeiter`." msgstr "在\\ :ref:`typeiter`\\ 文中可以找到更多資訊。" -#: ../../glossary.rst:671 +#: ../../glossary.rst:674 +msgid "" +"CPython does not consistently apply the requirement that an iterator define :" +"meth:`__iter__`." +msgstr "" + +#: ../../glossary.rst:676 msgid "key function" msgstr "key function（鍵函式）" -#: ../../glossary.rst:673 +#: ../../glossary.rst:678 msgid "" "A key function or collation function is a callable that returns a value used " "for sorting or ordering. For example, :func:`locale.strxfrm` is used to " @@ -1492,7 +1498,7 @@ msgstr "" "一個用於排序 (sorting) 或定序 (ordering) 的值。例如，\\ :func:`locale." "strxfrm` 被用來產生一個了解區域特定排序慣例的排序鍵。" -#: ../../glossary.rst:678 +#: ../../glossary.rst:683 msgid "" "A number of tools in Python accept key functions to control how elements are " "ordered or grouped. They include :func:`min`, :func:`max`, :func:`sorted`, :" @@ -1504,7 +1510,7 @@ msgstr "" "\\ 、\\ :func:`heapq.merge`\\ 、\\ :func:`heapq.nsmallest`\\ 、\\ :func:" "`heapq.nlargest` 和 :func:`itertools.groupby`\\ 。" -#: ../../glossary.rst:684 +#: ../../glossary.rst:689 msgid "" "There are several ways to create a key function. For example. the :meth:" "`str.lower` method can serve as a key function for case insensitive sorts. " @@ -1522,19 +1528,19 @@ msgstr "" "`~operator.itemgetter` 和 :func:`~operator.methodcaller`\\ 。關於如何建立和使" "用鍵函式的範例，請參閱\\ :ref:`如何排序 `\\ 。" -#: ../../glossary.rst:692 +#: ../../glossary.rst:697 msgid "keyword argument" msgstr "keyword argument（關鍵字引數）" -#: ../../glossary.rst:694 ../../glossary.rst:983 +#: ../../glossary.rst:699 ../../glossary.rst:988 msgid "See :term:`argument`." msgstr "請參閱 :term:`argument`\\ （引數）。" -#: ../../glossary.rst:695 +#: ../../glossary.rst:700 msgid "lambda" msgstr "lambda" -#: ../../glossary.rst:697 +#: ../../glossary.rst:702 msgid "" "An anonymous inline function consisting of a single :term:`expression` which " "is evaluated when the function is called. The syntax to create a lambda " @@ -1544,11 +1550,11 @@ msgstr "" "function)，於該函式被呼叫時求值。建立 lambda 函式的語法是 ``lambda " "[parameters]: expression``\\ 。" -#: ../../glossary.rst:700 +#: ../../glossary.rst:705 msgid "LBYL" msgstr "LBYL" -#: ../../glossary.rst:702 +#: ../../glossary.rst:707 msgid "" "Look before you leap. This coding style explicitly tests for pre-conditions " "before making calls or lookups. This style contrasts with the :term:`EAFP` " @@ -1559,7 +1565,7 @@ msgstr "" "地測試先決條件。這種風格與 :term:`EAFP` 方式形成對比，且它的特色是會有許多 :" "keyword:`if` 陳述式的存在。" -#: ../../glossary.rst:707 +#: ../../glossary.rst:712 msgid "" "In a multi-threaded environment, the LBYL approach can risk introducing a " "race condition between \"the looking\" and \"the leaping\". For example, " @@ -1573,37 +1579,37 @@ msgstr "" "了 *key*，則該程式碼就會失效。這個問題可以用鎖 (lock) 或使用 EAFP 編碼方式來" "解決。" -#: ../../glossary.rst:712 +#: ../../glossary.rst:717 msgid "locale encoding" msgstr "locale encoding（區域編碼）" -#: ../../glossary.rst:714 +#: ../../glossary.rst:719 msgid "" "On Unix, it is the encoding of the LC_CTYPE locale. It can be set with " "``locale.setlocale(locale.LC_CTYPE, new_locale)``." msgstr "" -#: ../../glossary.rst:717 +#: ../../glossary.rst:722 msgid "On Windows, it is the ANSI code page (ex: ``cp1252``)." msgstr "" -#: ../../glossary.rst:719 +#: ../../glossary.rst:724 msgid "" "``locale.getpreferredencoding(False)`` can be used to get the locale " "encoding." msgstr "" -#: ../../glossary.rst:722 +#: ../../glossary.rst:727 msgid "" "Python uses the :term:`filesystem encoding and error handler` to convert " "between Unicode filenames and bytes filenames." msgstr "" -#: ../../glossary.rst:724 +#: ../../glossary.rst:729 msgid "list" msgstr "list（串列）" -#: ../../glossary.rst:726 +#: ../../glossary.rst:731 msgid "" "A built-in Python :term:`sequence`. Despite its name it is more akin to an " "array in other languages than to a linked list since access to elements is " @@ -1613,11 +1619,11 @@ msgstr "" "似其他語言中的一個陣列 (array) 而較不像一個鏈結串列 (linked list)，因為存取元" "素的時間複雜度是 O(1)。" -#: ../../glossary.rst:729 +#: ../../glossary.rst:734 msgid "list comprehension" msgstr "list comprehension（串列綜合運算）" -#: ../../glossary.rst:731 +#: ../../glossary.rst:736 msgid "" "A compact way to process all or part of the elements in a sequence and " "return a list with the results. ``result = ['{:#04x}'.format(x) for x in " @@ -1631,11 +1637,11 @@ msgstr "" "keyword:`if` 子句是選擇性的。如果省略它，則 ``range(256)`` 中的所有元素都會被" "處理。" -#: ../../glossary.rst:737 +#: ../../glossary.rst:742 msgid "loader" msgstr "loader（載入器）" -#: ../../glossary.rst:739 +#: ../../glossary.rst:744 msgid "" "An object that loads a module. It must define a method named :meth:" "`load_module`. A loader is typically returned by a :term:`finder`. See :pep:" @@ -1647,19 +1653,19 @@ msgstr "" "`302`，關於 :term:`abstract base class`\\ （抽象基底類別），請參閱 :class:" "`importlib.abc.Loader`\\ 。" -#: ../../glossary.rst:743 +#: ../../glossary.rst:748 msgid "magic method" msgstr "magic method（魔術方法）" -#: ../../glossary.rst:747 +#: ../../glossary.rst:752 msgid "An informal synonym for :term:`special method`." msgstr ":term:`special method`\\ （特殊方法）的一個非正式同義詞。" -#: ../../glossary.rst:748 +#: ../../glossary.rst:753 msgid "mapping" msgstr "mapping（對映）" -#: ../../glossary.rst:750 +#: ../../glossary.rst:755 msgid "" "A container object that supports arbitrary key lookups and implements the " "methods specified in the :class:`~collections.abc.Mapping` or :class:" @@ -1674,11 +1680,11 @@ msgstr "" "的 method。範例包括 :class:`dict`\\ 、\\ :class:`collections.defaultdict`" "\\ 、\\ :class:`collections.OrderedDict` 和 :class:`collections.Counter`\\ 。" -#: ../../glossary.rst:756 +#: ../../glossary.rst:761 msgid "meta path finder" msgstr "meta path finder（元路徑尋檢器）" -#: ../../glossary.rst:758 +#: ../../glossary.rst:763 msgid "" "A :term:`finder` returned by a search of :data:`sys.meta_path`. Meta path " "finders are related to, but different from :term:`path entry finders ` " "相關但是不同。" -#: ../../glossary.rst:762 +#: ../../glossary.rst:767 msgid "" "See :class:`importlib.abc.MetaPathFinder` for the methods that meta path " "finders implement." @@ -1696,11 +1702,11 @@ msgstr "" "關於元路徑尋檢器實作的 method，請參閱 :class:`importlib.abc.MetaPathFinder`" "\\ 。" -#: ../../glossary.rst:764 +#: ../../glossary.rst:769 msgid "metaclass" msgstr "metaclass（元類別）" -#: ../../glossary.rst:766 +#: ../../glossary.rst:771 msgid "" "The class of a class. Class definitions create a class name, a class " "dictionary, and a list of base classes. The metaclass is responsible for " @@ -1720,15 +1726,15 @@ msgstr "" "性存取、增加執行緒安全性、追蹤物件建立、實作單例模式 (singleton)，以及許多其" "他的任務。" -#: ../../glossary.rst:776 +#: ../../glossary.rst:781 msgid "More information can be found in :ref:`metaclasses`." msgstr "更多資訊可以在\\ :ref:`metaclasses`\\ 章節中找到。" -#: ../../glossary.rst:777 +#: ../../glossary.rst:782 msgid "method" msgstr "method（方法）" -#: ../../glossary.rst:779 +#: ../../glossary.rst:784 msgid "" "A function which is defined inside a class body. If called as an attribute " "of an instance of that class, the method will get the instance object as its " @@ -1740,11 +1746,11 @@ msgstr "" "通常被稱為 ``self``）。請參閱 :term:`function`\\ （函式）和 :term:`nested " "scope`\\ （巢狀作用域）。" -#: ../../glossary.rst:783 +#: ../../glossary.rst:788 msgid "method resolution order" msgstr "method resolution order（方法解析順序）" -#: ../../glossary.rst:785 +#: ../../glossary.rst:790 msgid "" "Method Resolution Order is the order in which base classes are searched for " "a member during lookup. See `The Python 2.3 Method Resolution Order `_\\ 。" -#: ../../glossary.rst:789 +#: ../../glossary.rst:794 msgid "module" msgstr "module（模組）" -#: ../../glossary.rst:791 +#: ../../glossary.rst:796 msgid "" "An object that serves as an organizational unit of Python code. Modules " "have a namespace containing arbitrary Python objects. Modules are loaded " @@ -1769,15 +1775,15 @@ msgstr "" "空間，它包含任意的 Python 物件。模組是藉由 :term:`importing` 的過程，被載入" "至 Python。" -#: ../../glossary.rst:795 +#: ../../glossary.rst:800 msgid "See also :term:`package`." msgstr "另請參閱 :term:`package`\\ （套件）。" -#: ../../glossary.rst:796 +#: ../../glossary.rst:801 msgid "module spec" msgstr "module spec（模組規格）" -#: ../../glossary.rst:798 +#: ../../glossary.rst:803 msgid "" "A namespace containing the import-related information used to load a module. " "An instance of :class:`importlib.machinery.ModuleSpec`." @@ -1785,19 +1791,19 @@ msgstr "" "一個命名空間，它包含用於載入模組的 import 相關資訊。它是 :class:`importlib." "machinery.ModuleSpec` 的一個實例。" -#: ../../glossary.rst:800 +#: ../../glossary.rst:805 msgid "MRO" msgstr "MRO" -#: ../../glossary.rst:802 +#: ../../glossary.rst:807 msgid "See :term:`method resolution order`." msgstr "請參閱 :term:`method resolution order`\\ （方法解析順序）。" -#: ../../glossary.rst:803 +#: ../../glossary.rst:808 msgid "mutable" msgstr "mutable（可變物件）" -#: ../../glossary.rst:805 +#: ../../glossary.rst:810 msgid "" "Mutable objects can change their value but keep their :func:`id`. See also :" "term:`immutable`." @@ -1805,11 +1811,11 @@ msgstr "" "可變物件可以改變它們的值，但維持它們的 :func:`id`\\ 。另請參閱 :term:" "`immutable`\\ （不可變物件）。" -#: ../../glossary.rst:807 +#: ../../glossary.rst:812 msgid "named tuple" msgstr "named tuple（附名元組）" -#: ../../glossary.rst:809 +#: ../../glossary.rst:814 msgid "" "The term \"named tuple\" applies to any type or class that inherits from " "tuple and whose indexable elements are also accessible using named " @@ -1819,7 +1825,7 @@ msgstr "" "索引 (indexable) 元素也可以用附名屬性來存取。這些型別或 class 也可以具有其他" "的特性。" -#: ../../glossary.rst:813 +#: ../../glossary.rst:818 msgid "" "Several built-in types are named tuples, including the values returned by :" "func:`time.localtime` and :func:`os.stat`. Another example is :data:`sys." @@ -1830,7 +1836,7 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:824 +#: ../../glossary.rst:829 msgid "" "Some named tuples are built-in types (such as the above examples). " "Alternatively, a named tuple can be created from a regular class definition " @@ -1846,11 +1852,11 @@ msgstr "" "些額外的 method，這些 method 可能是在手寫或內建的 named tuple 中，無法找到" "的。" -#: ../../glossary.rst:831 +#: ../../glossary.rst:836 msgid "namespace" msgstr "namespace（命名空間）" -#: ../../glossary.rst:833 +#: ../../glossary.rst:838 msgid "" "The place where a variable is stored. Namespaces are implemented as " "dictionaries. There are the local, global and built-in namespaces as well " @@ -1870,11 +1876,11 @@ msgstr "" "func:`itertools.islice` 明確地表示，這些函式分別是由 :mod:`random` 和 :mod:" "`itertools` 模組在實作。" -#: ../../glossary.rst:843 +#: ../../glossary.rst:848 msgid "namespace package" msgstr "namespace package（命名空間套件）" -#: ../../glossary.rst:845 +#: ../../glossary.rst:850 msgid "" "A :pep:`420` :term:`package` which serves only as a container for " "subpackages. Namespace packages may have no physical representation, and " @@ -1885,15 +1891,15 @@ msgstr "" "一個容器。命名空間套件可能沒有實體的表示法，而且具體來說它們不像是一個 :term:" "`regular package`\\ （正規套件），因為它們並沒有 ``__init__.py`` 這個檔案。" -#: ../../glossary.rst:850 +#: ../../glossary.rst:855 msgid "See also :term:`module`." msgstr "另請參閱 :term:`module`\\ （模組）。" -#: ../../glossary.rst:851 +#: ../../glossary.rst:856 msgid "nested scope" msgstr "nested scope（巢狀作用域）" -#: ../../glossary.rst:853 +#: ../../glossary.rst:858 msgid "" "The ability to refer to a variable in an enclosing definition. For " "instance, a function defined inside another function can refer to variables " @@ -1908,11 +1914,11 @@ msgstr "" "寫入。同樣地，全域變數是在全域命名空間中讀取及寫入。\\ :keyword:`nonlocal` 容" "許對外層作用域進行寫入。" -#: ../../glossary.rst:860 +#: ../../glossary.rst:865 msgid "new-style class" msgstr "new-style class（新式類別）" -#: ../../glossary.rst:862 +#: ../../glossary.rst:867 msgid "" "Old name for the flavor of classes now used for all class objects. In " "earlier Python versions, only new-style classes could use Python's newer, " @@ -1924,11 +1930,11 @@ msgstr "" "__slots__`\\ 、描述器 (descriptor)、屬性 (property)、\\ :meth:" "`__getattribute__`\\ 、class method（類別方法）和 static method（靜態方法）。" -#: ../../glossary.rst:866 +#: ../../glossary.rst:871 msgid "object" msgstr "object（物件）" -#: ../../glossary.rst:868 +#: ../../glossary.rst:873 msgid "" "Any data with state (attributes or value) and defined behavior (methods). " "Also the ultimate base class of any :term:`new-style class`." @@ -1936,11 +1942,11 @@ msgstr "" "具有狀態（屬性或值）及被定義的行為（method）的任何資料。它也是任何 :term:" "`new-style class`\\ （新式類別）的最終 base class（基底類別）。" -#: ../../glossary.rst:871 +#: ../../glossary.rst:876 msgid "package" msgstr "package（套件）" -#: ../../glossary.rst:873 +#: ../../glossary.rst:878 msgid "" "A Python :term:`module` which can contain submodules or recursively, " "subpackages. Technically, a package is a Python module with an ``__path__`` " @@ -1950,17 +1956,17 @@ msgstr "" "迴的子套件 (subpackage)。技術上而言，套件就是具有 ``__path__`` 屬性的一個 " "Python 模組。" -#: ../../glossary.rst:877 +#: ../../glossary.rst:882 msgid "See also :term:`regular package` and :term:`namespace package`." msgstr "" "另請參閱 :term:`regular package`\\ （正規套件）和 :term:`namespace package`" "\\ （命名空間套件）。" -#: ../../glossary.rst:878 +#: ../../glossary.rst:883 msgid "parameter" msgstr "parameter（參數）" -#: ../../glossary.rst:880 +#: ../../glossary.rst:885 msgid "" "A named entity in a :term:`function` (or method) definition that specifies " "an :term:`argument` (or in some cases, arguments) that the function can " @@ -1970,7 +1976,7 @@ msgstr "" "它指明該函式能夠接受的一個 :term:`argument`\\ （引數），或在某些情況下指示多" "個引數。共有有五種不同的參數類型：" -#: ../../glossary.rst:884 +#: ../../glossary.rst:889 msgid "" ":dfn:`positional-or-keyword`: specifies an argument that can be passed " "either :term:`positionally ` or as a :term:`keyword argument " @@ -1983,7 +1989,7 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:893 +#: ../../glossary.rst:898 msgid "" ":dfn:`positional-only`: specifies an argument that can be supplied only by " "position. Positional-only parameters can be defined by including a ``/`` " @@ -1996,7 +2002,7 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:902 +#: ../../glossary.rst:907 msgid "" ":dfn:`keyword-only`: specifies an argument that can be supplied only by " "keyword. Keyword-only parameters can be defined by including a single var-" @@ -2011,7 +2017,7 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:910 +#: ../../glossary.rst:915 msgid "" ":dfn:`var-positional`: specifies that an arbitrary sequence of positional " "arguments can be provided (in addition to any positional arguments already " @@ -2025,7 +2031,7 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:918 +#: ../../glossary.rst:923 msgid "" ":dfn:`var-keyword`: specifies that arbitrarily many keyword arguments can be " "provided (in addition to any keyword arguments already accepted by other " @@ -2036,14 +2042,14 @@ msgstr "" "已被其他參數接受的任何關鍵字引數之外）。這類參數是透過在其參數名稱字首加上 " "``**`` 來定義的，例如上面範例中的 *kwargs*。" -#: ../../glossary.rst:924 +#: ../../glossary.rst:929 msgid "" "Parameters can specify both optional and required arguments, as well as " "default values for some optional arguments." msgstr "" "參數可以指明引數是選擇性的或必需的，也可以為一些選擇性的引數指定預設值。" -#: ../../glossary.rst:927 +#: ../../glossary.rst:932 msgid "" "See also the :term:`argument` glossary entry, the FAQ question on :ref:`the " "difference between arguments and parameters `, " @@ -2054,11 +2060,11 @@ msgstr "" "參數之間的差異 `\\ 、\\ :class:`inspect." "Parameter` class、\\ :ref:`function`\\ 章節，以及 :pep:`362`\\ 。" -#: ../../glossary.rst:931 +#: ../../glossary.rst:936 msgid "path entry" msgstr "path entry（路徑項目）" -#: ../../glossary.rst:933 +#: ../../glossary.rst:938 msgid "" "A single location on the :term:`import path` which the :term:`path based " "finder` consults to find modules for importing." @@ -2066,11 +2072,11 @@ msgstr "" "在 :term:`import path`\\ （匯入路徑）中的一個位置，而 :term:`path based " "finder` （基於路徑的尋檢器）會參考該位置來尋找要 import 的模組。" -#: ../../glossary.rst:935 +#: ../../glossary.rst:940 msgid "path entry finder" msgstr "path entry finder（路徑項目尋檢器）" -#: ../../glossary.rst:937 +#: ../../glossary.rst:942 msgid "" "A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. a :" "term:`path entry hook`) which knows how to locate modules given a :term:" @@ -2080,7 +2086,7 @@ msgstr "" "`path entry hook`\\ ）所回傳的一種 :term:`finder`\\ ，它知道如何以一個 :term:" "`path entry`\\ 定位模組。" -#: ../../glossary.rst:941 +#: ../../glossary.rst:946 msgid "" "See :class:`importlib.abc.PathEntryFinder` for the methods that path entry " "finders implement." @@ -2088,11 +2094,11 @@ msgstr "" "關於路徑項目尋檢器實作的 method，請參閱 :class:`importlib.abc." "PathEntryFinder`\\ 。" -#: ../../glossary.rst:943 +#: ../../glossary.rst:948 msgid "path entry hook" msgstr "path entry hook（路徑項目鉤）" -#: ../../glossary.rst:945 +#: ../../glossary.rst:950 msgid "" "A callable on the :data:`sys.path_hook` list which returns a :term:`path " "entry finder` if it knows how to find modules on a specific :term:`path " @@ -2102,11 +2108,11 @@ msgstr "" "個特定的 :term:`path entry` 中尋找模組，則會回傳一個 :term:`path entry " "finder`\\ （路徑項目尋檢器）。" -#: ../../glossary.rst:948 +#: ../../glossary.rst:953 msgid "path based finder" msgstr "path based finder（基於路徑的尋檢器）" -#: ../../glossary.rst:950 +#: ../../glossary.rst:955 msgid "" "One of the default :term:`meta path finders ` which " "searches an :term:`import path` for modules." @@ -2114,11 +2120,11 @@ msgstr "" "預設的\\ :term:`元路徑尋檢器 (meta path finder) ` 之一，它" "會在一個 :term:`import path` 中搜尋模組。" -#: ../../glossary.rst:952 +#: ../../glossary.rst:957 msgid "path-like object" msgstr "path-like object（類路徑物件）" -#: ../../glossary.rst:954 +#: ../../glossary.rst:959 msgid "" "An object representing a file system path. A path-like object is either a :" "class:`str` or :class:`bytes` object representing a path, or an object " @@ -2136,11 +2142,11 @@ msgstr "" "`os.fsencode` 則分別可用於確保 :class:`str` 及 :class:`bytes` 的結果。由 :" "pep:`519` 引入。" -#: ../../glossary.rst:962 +#: ../../glossary.rst:967 msgid "PEP" msgstr "PEP" -#: ../../glossary.rst:964 +#: ../../glossary.rst:969 msgid "" "Python Enhancement Proposal. A PEP is a design document providing " "information to the Python community, or describing a new feature for Python " @@ -2151,7 +2157,7 @@ msgstr "" "為 Python 社群提供資訊，或是描述 Python 的一個新功能或該功能的程序和環境。" "PEP 應該要提供簡潔的技術規範以及被提案功能的運作原理。" -#: ../../glossary.rst:970 +#: ../../glossary.rst:975 msgid "" "PEPs are intended to be the primary mechanisms for proposing major new " "features, for collecting community input on an issue, and for documenting " @@ -2163,15 +2169,15 @@ msgstr "" "已納入 Python 的設計決策的記錄，這些過程的主要機制。PEP 的作者要負責在社群內" "建立共識並記錄反對意見。" -#: ../../glossary.rst:976 +#: ../../glossary.rst:981 msgid "See :pep:`1`." msgstr "請參閱 :pep:`1`\\ 。" -#: ../../glossary.rst:977 +#: ../../glossary.rst:982 msgid "portion" msgstr "portion（部分）" -#: ../../glossary.rst:979 +#: ../../glossary.rst:984 msgid "" "A set of files in a single directory (possibly stored in a zip file) that " "contribute to a namespace package, as defined in :pep:`420`." @@ -2179,15 +2185,15 @@ msgstr "" "在單一目錄中的一組檔案（也可能儲存在一個 zip 檔中），這些檔案能對一個命名空間" "套件 (namespace package) 有所貢獻，如同 :pep:`420` 中的定義。" -#: ../../glossary.rst:981 +#: ../../glossary.rst:986 msgid "positional argument" msgstr "positional argument（位置引數）" -#: ../../glossary.rst:984 +#: ../../glossary.rst:989 msgid "provisional API" msgstr "provisional API（暫行 API）" -#: ../../glossary.rst:986 +#: ../../glossary.rst:991 msgid "" "A provisional API is one which has been deliberately excluded from the " "standard library's backwards compatibility guarantees. While major changes " @@ -2203,7 +2209,7 @@ msgstr "" "該介面）。這種變更並不會無端地產生——只有 API 被納入之前未察覺的嚴重基本缺陷被" "揭露時，它們才會發生。" -#: ../../glossary.rst:995 +#: ../../glossary.rst:1000 msgid "" "Even for provisional APIs, backwards incompatible changes are seen as a " "\"solution of last resort\" - every attempt will still be made to find a " @@ -2212,7 +2218,7 @@ msgstr "" "即使對於暫行 API，向後不相容的變更也會被視為「最後的解決方案」——對於任何被發" "現的問題，仍然會盡可能找出一個向後相容的解決方案。" -#: ../../glossary.rst:999 +#: ../../glossary.rst:1004 msgid "" "This process allows the standard library to continue to evolve over time, " "without locking in problematic design errors for extended periods of time. " @@ -2221,19 +2227,19 @@ msgstr "" "這個過程使得標準函式庫能隨著時間不斷進化，而避免耗費過長的時間去鎖定有問題的" "設計錯誤。請參閱 :pep:`411` 了解更多細節。" -#: ../../glossary.rst:1002 +#: ../../glossary.rst:1007 msgid "provisional package" msgstr "provisional package（暫行套件）" -#: ../../glossary.rst:1004 +#: ../../glossary.rst:1009 msgid "See :term:`provisional API`." msgstr "請參閱 :term:`provisional API`\\ （暫行 API）。" -#: ../../glossary.rst:1005 +#: ../../glossary.rst:1010 msgid "Python 3000" msgstr "Python 3000" -#: ../../glossary.rst:1007 +#: ../../glossary.rst:1012 msgid "" "Nickname for the Python 3.x release line (coined long ago when the release " "of version 3 was something in the distant future.) This is also abbreviated " @@ -2242,11 +2248,11 @@ msgstr "" "Python 3.x 系列版本的暱稱（很久以前創造的，當時第 3 版的發布是在遙遠的未" "來。）也可以縮寫為「Py3k」。" -#: ../../glossary.rst:1010 +#: ../../glossary.rst:1015 msgid "Pythonic" msgstr "Pythonic（Python 風格的）" -#: ../../glossary.rst:1012 +#: ../../glossary.rst:1017 msgid "" "An idea or piece of code which closely follows the most common idioms of the " "Python language, rather than implementing code using concepts common to " @@ -2262,18 +2268,18 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:1022 +#: ../../glossary.rst:1027 msgid "As opposed to the cleaner, Pythonic method::" msgstr "" "相較之下，以下方法更簡潔、更具有 Python 風格：\n" "\n" "::" -#: ../../glossary.rst:1026 +#: ../../glossary.rst:1031 msgid "qualified name" msgstr "qualified name（限定名稱）" -#: ../../glossary.rst:1028 +#: ../../glossary.rst:1033 msgid "" "A dotted name showing the \"path\" from a module's global scope to a class, " "function or method defined in that module, as defined in :pep:`3155`. For " @@ -2286,7 +2292,7 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:1045 +#: ../../glossary.rst:1050 msgid "" "When used to refer to modules, the *fully qualified name* means the entire " "dotted path to the module, including any parent packages, e.g. ``email.mime." @@ -2297,11 +2303,11 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:1052 +#: ../../glossary.rst:1057 msgid "reference count" msgstr "reference count（參照計數）" -#: ../../glossary.rst:1054 +#: ../../glossary.rst:1059 msgid "" "The number of references to an object. When the reference count of an " "object drops to zero, it is deallocated. Reference counting is generally " @@ -2315,11 +2321,11 @@ msgstr "" "`CPython` 實作的一個關鍵元素。\\ :mod:`sys` 模組定義了一個 :func:`~sys." "getrefcount` 函式，程序設計師可以呼叫該函式來回傳一個特定物件的參照計數。" -#: ../../glossary.rst:1060 +#: ../../glossary.rst:1065 msgid "regular package" msgstr "regular package（正規套件）" -#: ../../glossary.rst:1062 +#: ../../glossary.rst:1067 msgid "" "A traditional :term:`package`, such as a directory containing an ``__init__." "py`` file." @@ -2327,15 +2333,15 @@ msgstr "" "一個傳統的 :term:`package`\\ （套件），例如一個包含 ``__init__.py`` 檔案的目" "錄。" -#: ../../glossary.rst:1065 +#: ../../glossary.rst:1070 msgid "See also :term:`namespace package`." msgstr "另請參閱 :term:`namespace package`\\ （命名空間套件）。" -#: ../../glossary.rst:1066 +#: ../../glossary.rst:1071 msgid "__slots__" msgstr "__slots__" -#: ../../glossary.rst:1068 +#: ../../glossary.rst:1073 msgid "" "A declaration inside a class that saves memory by pre-declaring space for " "instance attributes and eliminating instance dictionaries. Though popular, " @@ -2348,11 +2354,11 @@ msgstr "" "最好保留給那種在一個記憶體關鍵 (memory-critical) 的應用程式中存在大量實例的罕" "見情況。" -#: ../../glossary.rst:1073 +#: ../../glossary.rst:1078 msgid "sequence" msgstr "sequence（序列）" -#: ../../glossary.rst:1075 +#: ../../glossary.rst:1080 msgid "" "An :term:`iterable` which supports efficient element access using integer " "indices via the :meth:`__getitem__` special method and defines a :meth:" @@ -2370,7 +2376,7 @@ msgstr "" "對映 (mapping) 而不是序列，因為其查找方式是使用任意的 :term:`immutable` 鍵，" "而不是整數。" -#: ../../glossary.rst:1084 +#: ../../glossary.rst:1089 msgid "" "The :class:`collections.abc.Sequence` abstract base class defines a much " "richer interface that goes beyond just :meth:`__getitem__` and :meth:" @@ -2384,11 +2390,11 @@ msgstr "" "`__reversed__`\\ 。實作此擴充介面的型別，可以使用 :func:`~abc.ABCMeta." "register` 被明確地註冊。" -#: ../../glossary.rst:1091 +#: ../../glossary.rst:1096 msgid "set comprehension" msgstr "set comprehension（集合綜合運算）" -#: ../../glossary.rst:1093 +#: ../../glossary.rst:1098 msgid "" "A compact way to process all or part of the elements in an iterable and " "return a set with the results. ``results = {c for c in 'abracadabra' if c " @@ -2399,11 +2405,11 @@ msgstr "" "set 回傳。``results = {c for c in 'abracadabra' if c not in 'abc'}`` 會產生一" "個字串 set：``{'r', 'd'}``。請參閱\\ :ref:`comprehensions`\\ 。" -#: ../../glossary.rst:1097 +#: ../../glossary.rst:1102 msgid "single dispatch" msgstr "single dispatch（單一調度）" -#: ../../glossary.rst:1099 +#: ../../glossary.rst:1104 msgid "" "A form of :term:`generic function` dispatch where the implementation is " "chosen based on the type of a single argument." @@ -2411,11 +2417,11 @@ msgstr "" ":term:`generic function`\\ （泛型函式）調度的一種形式，在此，實作的選擇是基於" "單一引數的型別。" -#: ../../glossary.rst:1101 +#: ../../glossary.rst:1106 msgid "slice" msgstr "slice（切片）" -#: ../../glossary.rst:1103 +#: ../../glossary.rst:1108 msgid "" "An object usually containing a portion of a :term:`sequence`. A slice is " "created using the subscript notation, ``[]`` with colons between numbers " @@ -2427,11 +2433,11 @@ msgstr "" "之間使用冒號，例如 ``in variable_name[1:3:5]``。在括號（下標）符號的內部，會" "使用 :class:`slice` 物件。" -#: ../../glossary.rst:1107 +#: ../../glossary.rst:1112 msgid "special method" msgstr "special method（特殊方法）" -#: ../../glossary.rst:1111 +#: ../../glossary.rst:1116 msgid "" "A method that is called implicitly by Python to execute a certain operation " "on a type, such as addition. Such methods have names starting and ending " @@ -2442,11 +2448,11 @@ msgstr "" "種 method 的名稱會在開頭和結尾有兩個下底線。Special method 在\\ :ref:" "`specialnames`\\ 中有詳細說明。" -#: ../../glossary.rst:1115 +#: ../../glossary.rst:1120 msgid "statement" msgstr "statement（陳述式）" -#: ../../glossary.rst:1117 +#: ../../glossary.rst:1122 msgid "" "A statement is part of a suite (a \"block\" of code). A statement is either " "an :term:`expression` or one of several constructs with a keyword, such as :" @@ -2456,18 +2462,18 @@ msgstr "" "term:`expression`\\ （運算式），或是含有關鍵字（例如 :keyword:`if`\\ 、\\ :" "keyword:`while` 或 :keyword:`for`\\ ）的多種結構之一。" -#: ../../glossary.rst:1120 +#: ../../glossary.rst:1125 msgid "strong reference" msgstr "" -#: ../../glossary.rst:1122 +#: ../../glossary.rst:1127 msgid "" "In Python's C API, a strong reference is a reference to an object which " "increments the object's reference count when it is created and decrements " "the object's reference count when it is deleted." msgstr "" -#: ../../glossary.rst:1126 +#: ../../glossary.rst:1131 msgid "" "The :c:func:`Py_NewRef` function can be used to create a strong reference to " "an object. Usually, the :c:func:`Py_DECREF` function must be called on the " @@ -2475,23 +2481,23 @@ msgid "" "leaking one reference." msgstr "" -#: ../../glossary.rst:1131 +#: ../../glossary.rst:1136 msgid "See also :term:`borrowed reference`." msgstr "另請參閱 :term:`borrowed reference`\\ 。" -#: ../../glossary.rst:1132 +#: ../../glossary.rst:1137 msgid "text encoding" msgstr "text encoding（文字編碼）" -#: ../../glossary.rst:1134 +#: ../../glossary.rst:1139 msgid "A codec which encodes Unicode strings to bytes." msgstr "將 Unicode 字串編碼為位元組的一個編解碼器 (codec)。" -#: ../../glossary.rst:1135 +#: ../../glossary.rst:1140 msgid "text file" msgstr "text file（文字檔案）" -#: ../../glossary.rst:1137 +#: ../../glossary.rst:1142 msgid "" "A :term:`file object` able to read and write :class:`str` objects. Often, a " "text file actually accesses a byte-oriented datastream and handles the :term:" @@ -2505,7 +2511,7 @@ msgstr "" "有：以文字模式（``'r'`` 或 ``'w'``）開啟的檔案、\\ :data:`sys.stdin`\\ 、\\ :" "data:`sys.stdout` 以及 :class:`io.StringIO` 的實例。" -#: ../../glossary.rst:1144 +#: ../../glossary.rst:1149 msgid "" "See also :term:`binary file` for a file object able to read and write :term:" "`bytes-like objects `." @@ -2513,11 +2519,11 @@ msgstr "" "另請參閱 :term:`binary file`\\ （二進制檔案），它是一個能夠讀取和寫入\\ :" "term:`類位元組串物件 (bytes-like object) ` 的檔案物件。" -#: ../../glossary.rst:1146 +#: ../../glossary.rst:1151 msgid "triple-quoted string" msgstr "triple-quoted string（三引號內字串）" -#: ../../glossary.rst:1148 +#: ../../glossary.rst:1153 msgid "" "A string which is bound by three instances of either a quotation mark (\") " "or an apostrophe ('). While they don't provide any functionality not " @@ -2532,11 +2538,11 @@ msgstr "" "中包含未跳脫 (unescaped) 的單引號和雙引號，而且它們不需使用連續字元 " "(continuation character) 就可以跨越多行，這使得它們在編寫說明字串時特別有用。" -#: ../../glossary.rst:1155 +#: ../../glossary.rst:1160 msgid "type" msgstr "type（型別）" -#: ../../glossary.rst:1157 +#: ../../glossary.rst:1162 msgid "" "The type of a Python object determines what kind of object it is; every " "object has a type. An object's type is accessible as its :attr:`~instance." @@ -2546,15 +2552,15 @@ msgstr "" "件的型別可以用它的 :attr:`~instance.__class__` 屬性來存取，或以 " "``type(obj)`` 來檢索。" -#: ../../glossary.rst:1161 +#: ../../glossary.rst:1166 msgid "type alias" msgstr "type alias（型別別名）" -#: ../../glossary.rst:1163 +#: ../../glossary.rst:1168 msgid "A synonym for a type, created by assigning the type to an identifier." msgstr "一個型別的同義詞，透過將型別指定給一個識別符 (identifier) 來建立。" -#: ../../glossary.rst:1165 +#: ../../glossary.rst:1170 msgid "" "Type aliases are useful for simplifying :term:`type hints `. For " "example::" @@ -2563,22 +2569,22 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:1172 +#: ../../glossary.rst:1177 msgid "could be made more readable like this::" msgstr "" "可以寫成這樣，更具有可讀性：\n" "\n" "::" -#: ../../glossary.rst:1179 ../../glossary.rst:1193 +#: ../../glossary.rst:1184 ../../glossary.rst:1198 msgid "See :mod:`typing` and :pep:`484`, which describe this functionality." msgstr "請參閱 :mod:`typing` 和 :pep:`484`\\ ，有此功能的描述。" -#: ../../glossary.rst:1180 +#: ../../glossary.rst:1185 msgid "type hint" msgstr "type hint（型別提示）" -#: ../../glossary.rst:1182 +#: ../../glossary.rst:1187 msgid "" "An :term:`annotation` that specifies the expected type for a variable, a " "class attribute, or a function parameter or return value." @@ -2586,7 +2592,7 @@ msgstr "" "一種 :term:`annotation`\\ （註釋），它指定一個變數、一個 class 屬性或一個函式" "的參數或回傳值的預期型別。" -#: ../../glossary.rst:1185 +#: ../../glossary.rst:1190 msgid "" "Type hints are optional and are not enforced by Python but they are useful " "to static type analysis tools, and aid IDEs with code completion and " @@ -2595,7 +2601,7 @@ msgstr "" "型別提示是選擇性的，而不是被 Python 強制的，但它們對靜態型別分析工具很有用，" "並能協助 IDE 完成程式碼的補全 (completion) 和重構 (refactoring)。" -#: ../../glossary.rst:1189 +#: ../../glossary.rst:1194 msgid "" "Type hints of global variables, class attributes, and functions, but not " "local variables, can be accessed using :func:`typing.get_type_hints`." @@ -2603,11 +2609,11 @@ msgstr "" "全域變數、class 屬性和函式（不含區域變數）的型別提示，都可以使用 :func:" "`typing.get_type_hints` 來存取。" -#: ../../glossary.rst:1194 +#: ../../glossary.rst:1199 msgid "universal newlines" msgstr "universal newlines（通用換行字元）" -#: ../../glossary.rst:1196 +#: ../../glossary.rst:1201 msgid "" "A manner of interpreting text streams in which all of the following are " "recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the " @@ -2620,15 +2626,15 @@ msgstr "" "``'\\r'``。請參閱 :pep:`278` 和 :pep:`3116`\\ ，以及用於 :func:`bytes." "splitlines` 的附加用途。" -#: ../../glossary.rst:1201 +#: ../../glossary.rst:1206 msgid "variable annotation" msgstr "variable annotation（變數註釋）" -#: ../../glossary.rst:1203 +#: ../../glossary.rst:1208 msgid "An :term:`annotation` of a variable or a class attribute." msgstr "一個變數或 class 屬性的 :term:`annotation`\\ （註釋）。" -#: ../../glossary.rst:1205 +#: ../../glossary.rst:1210 msgid "" "When annotating a variable or a class attribute, assignment is optional::" msgstr "" @@ -2636,7 +2642,7 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:1210 +#: ../../glossary.rst:1215 msgid "" "Variable annotations are usually used for :term:`type hints `: " "for example this variable is expected to take :class:`int` values::" @@ -2646,11 +2652,11 @@ msgstr "" "\n" "::" -#: ../../glossary.rst:1216 +#: ../../glossary.rst:1221 msgid "Variable annotation syntax is explained in section :ref:`annassign`." msgstr "變數註釋的語法在\\ :ref:`annassign`\\ 章節有詳細的解釋。" -#: ../../glossary.rst:1218 +#: ../../glossary.rst:1223 msgid "" "See :term:`function annotation`, :pep:`484` and :pep:`526`, which describe " "this functionality. Also see :ref:`annotations-howto` for best practices on " @@ -2660,11 +2666,11 @@ msgstr "" "`526`\\ ，皆有此功能的描述。關於註釋的最佳實踐方法，另請參閱 :ref:" "`annotations-howto`\\ 。" -#: ../../glossary.rst:1222 +#: ../../glossary.rst:1227 msgid "virtual environment" msgstr "virtual environment（虛擬環境）" -#: ../../glossary.rst:1224 +#: ../../glossary.rst:1229 msgid "" "A cooperatively isolated runtime environment that allows Python users and " "applications to install and upgrade Python distribution packages without " @@ -2675,15 +2681,15 @@ msgstr "" "程式得以安裝和升級 Python 發佈套件，而不會對同一個系統上運行的其他 Python 應" "用程式的行為產生干擾。" -#: ../../glossary.rst:1229 +#: ../../glossary.rst:1234 msgid "See also :mod:`venv`." msgstr "另請參閱 :mod:`venv`\\ 。" -#: ../../glossary.rst:1230 +#: ../../glossary.rst:1235 msgid "virtual machine" msgstr "virtual machine（虛擬機器）" -#: ../../glossary.rst:1232 +#: ../../glossary.rst:1237 msgid "" "A computer defined entirely in software. Python's virtual machine executes " "the :term:`bytecode` emitted by the bytecode compiler." @@ -2691,11 +2697,11 @@ msgstr "" "一部完全由軟體所定義的電腦 (computer)。Python 的虛擬機器會執行由 :term:" "`bytecode`\\ （位元組碼）編譯器所發出的位元組碼。" -#: ../../glossary.rst:1234 +#: ../../glossary.rst:1239 msgid "Zen of Python" msgstr "Zen of Python（Python 之禪）" -#: ../../glossary.rst:1236 +#: ../../glossary.rst:1241 msgid "" "Listing of Python design principles and philosophies that are helpful in " "understanding and using the language. The listing can be found by typing " diff --git a/library/asyncio-future.po b/library/asyncio-future.po index 3b11f72f40..ee693cb06d 100644 --- a/library/asyncio-future.po +++ b/library/asyncio-future.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-11-17 00:09+0000\n" +"POT-Creation-Date: 2021-11-22 09:18+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -24,11 +24,11 @@ msgstr "" #: ../../library/asyncio-future.rst:10 msgid "" -"**Source code:** :source:`Lib/asyncio/futures.py`, " -"" +"**Source code:** :source:`Lib/asyncio/futures.py`, :source:`Lib/asyncio/" +"base_futures.py`" msgstr "" -"**原始碼：**\\ :source:`Lib/asyncio/futures.py`\\ 、\\ " -":source:`Lib/asyncio/base_futures.py`" +"**原始碼：**\\ :source:`Lib/asyncio/futures.py`\\ 、\\ :source:`Lib/asyncio/" +"base_futures.py`" #: ../../library/asyncio-future.rst:15 msgid "" diff --git a/library/asyncio-platforms.po b/library/asyncio-platforms.po index 6143e2d16a..38142ab342 100644 --- a/library/asyncio-platforms.po +++ b/library/asyncio-platforms.po @@ -48,6 +48,9 @@ msgid "" "**Source code:** :source:`Lib/asyncio/proactor_events.py`, :source:`Lib/" "asyncio/windows_events.py`, :source:`Lib/asyncio/windows_utils.py`" msgstr "" +"**原始碼：**\\ :source:`Lib/asyncio/proactor_events.py`\\ 、\\ " +":source:`Lib/asyncio/windows_events.py`\\ 、\\ :source:`Lib/asyncio/" +"windows_utils.py`" #: ../../library/asyncio-platforms.rst:34 msgid "On Windows, :class:`ProactorEventLoop` is now the default event loop." diff --git a/library/asyncio-subprocess.po b/library/asyncio-subprocess.po index afa0ca68f0..7319ff5b10 100644 --- a/library/asyncio-subprocess.po +++ b/library/asyncio-subprocess.po @@ -28,6 +28,8 @@ msgid "" "**Source code:** :source:`Lib/asyncio/subprocess.py`, :source:`Lib/asyncio/" "base_subprocess.py`" msgstr "" +"**原始碼：**\\ :source:`Lib/asyncio/subprocess.py`\\ 、\\ :source:`Lib/" +"asyncio/base_subprocess.py`" #: ../../library/asyncio-subprocess.rst:14 msgid "" diff --git a/library/concurrent.futures.po b/library/concurrent.futures.po index f86274485e..265d017c6e 100644 --- a/library/concurrent.futures.po +++ b/library/concurrent.futures.po @@ -27,6 +27,8 @@ msgid "" "**Source code:** :source:`Lib/concurrent/futures/thread.py` and :source:`Lib/" "concurrent/futures/process.py`" msgstr "" +"**原始碼：**\\ :source:`Lib/concurrent/futures/thread.py` 與 :source:`Lib/" +"concurrent/futures/process.py`" #: ../../library/concurrent.futures.rst:14 msgid "" diff --git a/library/functions.po b/library/functions.po index cff9e65f83..54b1488acd 100644 --- a/library/functions.po +++ b/library/functions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-11-03 00:08+0000\n" +"POT-Creation-Date: 2021-11-23 00:09+0000\n" "PO-Revision-Date: 2018-11-10 18:27+0800\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -411,16 +411,10 @@ msgid "" msgstr "" #: ../../library/functions.rst:69 -msgid "" -"``aiter(x)`` itself has an ``__aiter__()`` method that returns ``x``, so " -"``aiter(aiter(x))`` is the same as ``aiter(x)``." -msgstr "" - -#: ../../library/functions.rst:72 msgid "Note: Unlike :func:`iter`, :func:`aiter` has no 2-argument variant." msgstr "" -#: ../../library/functions.rst:78 +#: ../../library/functions.rst:75 #, fuzzy msgid "" "Return ``True`` if all elements of the *iterable* are true (or if the " @@ -429,18 +423,18 @@ msgstr "" "如果 *iterable* 的所有元素為 True（或 iterable 為空），返回 ``True`` 。等價" "於::" -#: ../../library/functions.rst:90 +#: ../../library/functions.rst:87 msgid "" "When awaited, return the next item from the given :term:`asynchronous " "iterator`, or *default* if given and the iterator is exhausted." msgstr "" -#: ../../library/functions.rst:93 +#: ../../library/functions.rst:90 msgid "" "This is the async variant of the :func:`next` builtin, and behaves similarly." msgstr "" -#: ../../library/functions.rst:96 +#: ../../library/functions.rst:93 msgid "" "This calls the :meth:`~object.__anext__` method of *async_iterator*, " "returning an :term:`awaitable`. Awaiting this returns the next value of the " @@ -448,7 +442,7 @@ msgid "" "exhausted, otherwise :exc:`StopAsyncIteration` is raised." msgstr "" -#: ../../library/functions.rst:105 +#: ../../library/functions.rst:102 #, fuzzy msgid "" "Return ``True`` if any element of the *iterable* is true. If the iterable " @@ -457,7 +451,7 @@ msgstr "" "如果 *iterable* 的任一元素為 True，返回 ``True`` 。如果 iterable 為空，返回 " "``False``。等價於::" -#: ../../library/functions.rst:117 +#: ../../library/functions.rst:114 #, fuzzy msgid "" "As :func:`repr`, return a string containing a printable representation of an " @@ -469,7 +463,7 @@ msgstr "" "中非 ASCII 編碼的字元，會使用 ``\\x``、``\\u`` 和 ``\\U`` 來轉義。生成的字串" "和 Python 2 的 :func:`repr` 返回的結果相似。" -#: ../../library/functions.rst:125 +#: ../../library/functions.rst:122 #, fuzzy msgid "" "Convert an integer number to a binary string prefixed with \"0b\". The " @@ -481,20 +475,20 @@ msgstr "" "式。如果 *x* 不是 Python 的 :class:`int` 物件，那它需要定義 :meth:" "`__index__` 方法返回一個整數。一些例子：" -#: ../../library/functions.rst:135 +#: ../../library/functions.rst:132 #, fuzzy msgid "" "If the prefix \"0b\" is desired or not, you can use either of the following " "ways." msgstr "如果不一定需要字首“0b”，還可以使用如下的方法。" -#: ../../library/functions.rst:142 ../../library/functions.rst:807 -#: ../../library/functions.rst:1102 +#: ../../library/functions.rst:139 ../../library/functions.rst:804 +#: ../../library/functions.rst:1099 #, fuzzy msgid "See also :func:`format` for more information." msgstr "另見 :func:`format` 獲取更多資訊。" -#: ../../library/functions.rst:147 +#: ../../library/functions.rst:144 #, fuzzy msgid "" "Return a Boolean value, i.e. one of ``True`` or ``False``. *x* is converted " @@ -510,12 +504,12 @@ msgstr "" "`typesnumeric`）。其他類不能繼承自它。它只有 ``False`` 和 ``True`` 兩個例項" "（參見 :ref:`bltin-boolean-values`）。" -#: ../../library/functions.rst:156 ../../library/functions.rst:675 -#: ../../library/functions.rst:891 +#: ../../library/functions.rst:153 ../../library/functions.rst:672 +#: ../../library/functions.rst:888 msgid "*x* is now a positional-only parameter." msgstr "" -#: ../../library/functions.rst:161 +#: ../../library/functions.rst:158 msgid "" "This function drops you into the debugger at the call site. Specifically, " "it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight " @@ -527,13 +521,13 @@ msgid "" "you to drop into the debugger of choice." msgstr "" -#: ../../library/functions.rst:171 +#: ../../library/functions.rst:168 msgid "" "Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " "argument ``breakpointhook``." msgstr "" -#: ../../library/functions.rst:179 +#: ../../library/functions.rst:176 #, fuzzy msgid "" "Return a new array of bytes. The :class:`bytearray` class is a mutable " @@ -545,14 +539,14 @@ msgstr "" "<= x < 256 的整數。它有可變序列大部分常見的方法，見 :ref:`typesseq-mutable` " "的描述；同時有 :class:`bytes` 型別的大部分方法，參見 :ref:`bytes-methods`。" -#: ../../library/functions.rst:184 +#: ../../library/functions.rst:181 #, fuzzy msgid "" "The optional *source* parameter can be used to initialize the array in a few " "different ways:" msgstr "可選形參 *source* 可以用不同的方式來初始化陣列：" -#: ../../library/functions.rst:187 +#: ../../library/functions.rst:184 #, fuzzy msgid "" "If it is a *string*, you must also give the *encoding* (and optionally, " @@ -562,7 +556,7 @@ msgstr "" "如果是一個 *string*，您必須提供 *encoding* 引數（*errors* 引數仍是可選的）；:" "func:`bytearray` 會使用 :meth:`str.encode` 方法來將 string 轉變成 bytes。" -#: ../../library/functions.rst:191 +#: ../../library/functions.rst:188 #, fuzzy msgid "" "If it is an *integer*, the array will have that size and will be initialized " @@ -570,7 +564,7 @@ msgid "" msgstr "" "如果是一個 *integer*，會初始化大小為該數字的陣列，並使用 null 位元組填充。" -#: ../../library/functions.rst:194 +#: ../../library/functions.rst:191 #, fuzzy msgid "" "If it is an object conforming to the :ref:`buffer interface " @@ -580,7 +574,7 @@ msgstr "" "如果是一個符合 *buffer* 介面的物件，該物件的只讀 buffer 會用來初始化位元組陣" "列。" -#: ../../library/functions.rst:197 +#: ../../library/functions.rst:194 #, fuzzy msgid "" "If it is an *iterable*, it must be an iterable of integers in the range ``0 " @@ -589,17 +583,17 @@ msgstr "" "如果是一個 *iterable* 可迭代物件，它的元素的範圍必須是 ``0 <= x < 256`` 的整" "數，它會被用作陣列的初始內容。" -#: ../../library/functions.rst:200 +#: ../../library/functions.rst:197 #, fuzzy msgid "Without an argument, an array of size 0 is created." msgstr "如果沒有實參，則建立大小為 0 的陣列。" -#: ../../library/functions.rst:202 +#: ../../library/functions.rst:199 #, fuzzy msgid "See also :ref:`binaryseq` and :ref:`typebytearray`." msgstr "另見 :ref:`binaryseq` 和 :ref:`typebytearray`。" -#: ../../library/functions.rst:209 +#: ../../library/functions.rst:206 #, fuzzy msgid "" "Return a new \"bytes\" object which is an immutable sequence of integers in " @@ -611,23 +605,23 @@ msgstr "" "數。:class:`bytes` 是 :class:`bytearray` 的不可變版本 - 它有其中不改變序列的" "方法和相同的索引、切片操作。" -#: ../../library/functions.rst:214 +#: ../../library/functions.rst:211 #, fuzzy msgid "" "Accordingly, constructor arguments are interpreted as for :func:`bytearray`." msgstr "因此，建構函式的實參和 :func:`bytearray` 相同。" -#: ../../library/functions.rst:216 +#: ../../library/functions.rst:213 #, fuzzy msgid "Bytes objects can also be created with literals, see :ref:`strings`." msgstr "位元組物件還可以用字面值建立，參見 :ref:`strings`。" -#: ../../library/functions.rst:218 +#: ../../library/functions.rst:215 #, fuzzy msgid "See also :ref:`binaryseq`, :ref:`typebytes`, and :ref:`bytes-methods`." msgstr "另見 :ref:`binaryseq`，:ref:`typebytes` 和 :ref:`bytes-methods`。" -#: ../../library/functions.rst:223 +#: ../../library/functions.rst:220 #, fuzzy msgid "" "Return :const:`True` if the *object* argument appears callable, :const:" @@ -641,14 +635,14 @@ msgstr "" "是可呼叫的（呼叫類會返回一個新的例項）。如果例項的類有 :meth:`__call__` 方" "法，則它是可呼叫。" -#: ../../library/functions.rst:229 +#: ../../library/functions.rst:226 #, fuzzy msgid "" "This function was first removed in Python 3.0 and then brought back in " "Python 3.2." msgstr "這個函式一開始在 Python 3.0 被移除了，但在 Python 3.2 被重新加入。" -#: ../../library/functions.rst:236 +#: ../../library/functions.rst:233 #, fuzzy msgid "" "Return the string representing a character whose Unicode code point is the " @@ -658,7 +652,7 @@ msgstr "" "返回 Unicode 碼位為整數 *i* 的字元的字串格式。例如，``chr(97)`` 返回字串 " "``'a'``，``chr(8364)`` 返回字串 ``'€'``。這是 :func:`ord` 的逆函式。" -#: ../../library/functions.rst:240 +#: ../../library/functions.rst:237 #, fuzzy msgid "" "The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in " @@ -667,12 +661,12 @@ msgstr "" "實參的合法範圍是 0 到 1,114,111（16 進製表示是 0x10FFFF）。如果 *i* 超過這個" "範圍，會觸發 :exc:`ValueError` 異常。" -#: ../../library/functions.rst:246 +#: ../../library/functions.rst:243 #, fuzzy msgid "Transform a method into a class method." msgstr "把一個方法封裝成類方法。" -#: ../../library/functions.rst:248 +#: ../../library/functions.rst:245 #, fuzzy msgid "" "A class method receives the class as an implicit first argument, just like " @@ -682,7 +676,7 @@ msgstr "" "一個類方法把類自己作為第一個實參，就像一個例項方法把例項自己作為第一個實參。" "請用以下習慣來宣告類方法::" -#: ../../library/functions.rst:256 +#: ../../library/functions.rst:253 #, fuzzy msgid "" "The ``@classmethod`` form is a function :term:`decorator` -- see :ref:" @@ -691,7 +685,7 @@ msgstr "" "``@classmethod`` 形式是一個函式 :term:`decorator` - 參見 :ref:`function` 中關" "於函式定義的詳細介紹。" -#: ../../library/functions.rst:259 +#: ../../library/functions.rst:256 #, fuzzy msgid "" "A class method can be called either on the class (such as ``C.f()``) or on " @@ -702,7 +696,7 @@ msgstr "" "它可以同時在類（如 ``C.f()``）和例項（如 ``C().f()``）上呼叫。例項除了它的類" "資訊，其他都會被忽略。如果一個類方法在子類上呼叫，子類會作為第一個實參傳入。" -#: ../../library/functions.rst:264 +#: ../../library/functions.rst:261 #, fuzzy msgid "" "Class methods are different than C++ or Java static methods. If you want " @@ -712,20 +706,20 @@ msgstr "" "類方法和 C++ 和 Java 的靜態方法是有區別的。如果你想要靜態方法，請看本節的 :" "func:`staticmethod`。" -#: ../../library/functions.rst:268 +#: ../../library/functions.rst:265 msgid "" "Class methods can now wrap other :term:`descriptors ` such as :" "func:`property`." msgstr "" -#: ../../library/functions.rst:272 +#: ../../library/functions.rst:269 msgid "" "Class methods now inherit the method attributes (``__module__``, " "``__name__``, ``__qualname__``, ``__doc__`` and ``__annotations__``) and " "have a new ``__wrapped__`` attribute." msgstr "" -#: ../../library/functions.rst:279 +#: ../../library/functions.rst:276 #, fuzzy msgid "" "Compile the *source* into a code or AST object. Code objects can be " @@ -737,7 +731,7 @@ msgstr "" "`eval` 執行。*source* 可以是常規的字串、位元組字串，或者 AST 物件。參見 :mod:" "`ast` 模組的文件瞭解如何使用 AST 物件。" -#: ../../library/functions.rst:284 +#: ../../library/functions.rst:281 #, fuzzy msgid "" "The *filename* argument should give the file from which the code was read; " @@ -747,7 +741,7 @@ msgstr "" "*filename* 實參需要是程式碼讀取的檔名；如果程式碼不需要從檔案中讀取，可以傳入" "一些可辨識的值（經常會使用 ``''``）。" -#: ../../library/functions.rst:288 +#: ../../library/functions.rst:285 #, fuzzy msgid "" "The *mode* argument specifies what kind of code must be compiled; it can be " @@ -761,7 +755,7 @@ msgstr "" "是 ``'single'``。（在最後一種情況下，如果表示式執行結果不是 ``None`` 將會被打" "印出來。）" -#: ../../library/functions.rst:294 +#: ../../library/functions.rst:291 msgid "" "The optional arguments *flags* and *dont_inherit* control which :ref:" "`compiler options ` should be activated and which :ref:" @@ -775,7 +769,7 @@ msgid "" "in the surrounding code are ignored." msgstr "" -#: ../../library/functions.rst:305 +#: ../../library/functions.rst:302 #, fuzzy msgid "" "Compiler options and future statements are specified by bits which can be " @@ -789,7 +783,7 @@ msgstr "" "以通過 :mod:`__future__` 模組中的 :class:`~__future__._Feature` 類的例項的 :" "attr:`~__future__._Feature.compiler_flag` 屬性來獲得。" -#: ../../library/functions.rst:313 +#: ../../library/functions.rst:310 #, fuzzy msgid "" "The argument *optimize* specifies the optimization level of the compiler; " @@ -802,7 +796,7 @@ msgstr "" "O` 選項相同的優化級別。顯式級別為 ``0`` （沒有優化；``__debug__`` 為真）、" "``1`` （斷言被刪除， ``__debug__`` 為假）或 ``2`` （文件字串也被刪除）。" -#: ../../library/functions.rst:319 +#: ../../library/functions.rst:316 #, fuzzy msgid "" "This function raises :exc:`SyntaxError` if the compiled source is invalid, " @@ -811,27 +805,27 @@ msgstr "" "如果編譯的原始碼不合法，此函式會觸發 :exc:`SyntaxError` 異常；如果原始碼包含 " "null 位元組，則會觸發 :exc:`ValueError` 異常。" -#: ../../library/functions.rst:322 +#: ../../library/functions.rst:319 #, fuzzy msgid "" "If you want to parse Python code into its AST representation, see :func:`ast." "parse`." msgstr "如果您想分析 Python 程式碼的 AST 表示，請參閱 :func:`ast.parse`。" -#: ../../library/functions.rst:325 +#: ../../library/functions.rst:322 msgid "" "Raises an :ref:`auditing event ` ``compile`` with arguments " "``source``, ``filename``." msgstr "" -#: ../../library/functions.rst:327 +#: ../../library/functions.rst:324 msgid "" "Raises an :ref:`auditing event ` ``compile`` with arguments " "``source`` and ``filename``. This event may also be raised by implicit " "compilation." msgstr "" -#: ../../library/functions.rst:333 +#: ../../library/functions.rst:330 #, fuzzy msgid "" "When compiling a string with multi-line code in ``'single'`` or ``'eval'`` " @@ -842,7 +836,7 @@ msgstr "" "在 ``'single'`` 或 ``'eval'`` 模式編譯多行程式碼字串時，輸入必須以至少一個換" "行符結尾。 這使 :mod:`code` 模組更容易檢測語句的完整性。" -#: ../../library/functions.rst:340 +#: ../../library/functions.rst:337 #, fuzzy msgid "" "It is possible to crash the Python interpreter with a sufficiently large/" @@ -852,7 +846,7 @@ msgstr "" "如果編譯足夠大或者足夠複雜的字串成 AST 物件時，Python 直譯器會因為 Python " "AST 編譯器的棧深度限制而奔潰。" -#: ../../library/functions.rst:344 +#: ../../library/functions.rst:341 #, fuzzy msgid "" "Allowed use of Windows and Mac newlines. Also, input in ``'exec'`` mode " @@ -861,20 +855,20 @@ msgstr "" "允許使用 Windows 和 Mac 的換行符。在 ``'exec'`` 模式不再需要以換行符結尾。增" "加了 *optimize* 形參。" -#: ../../library/functions.rst:348 +#: ../../library/functions.rst:345 #, fuzzy msgid "" "Previously, :exc:`TypeError` was raised when null bytes were encountered in " "*source*." msgstr "之前 *source* 中包含 null 位元組的話會觸發 :exc:`TypeError` 異常。" -#: ../../library/functions.rst:352 +#: ../../library/functions.rst:349 msgid "" "``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` can now be passed in flags to enable " "support for top-level ``await``, ``async for``, and ``async with``." msgstr "" -#: ../../library/functions.rst:359 +#: ../../library/functions.rst:356 #, fuzzy msgid "" "Return a complex number with the value *real* + *imag*\\*1j or convert a " @@ -892,7 +886,7 @@ msgstr "" "預設值為零，建構函式會像 :class:`int` 和 :class:`float` 一樣進行數值轉換。如" "果兩個實參都省略，則返回 ``0j``。" -#: ../../library/functions.rst:368 +#: ../../library/functions.rst:365 msgid "" "For a general Python object ``x``, ``complex(x)`` delegates to ``x." "__complex__()``. If ``__complex__()`` is not defined then it falls back to :" @@ -900,7 +894,7 @@ msgid "" "meth:`__index__`." msgstr "" -#: ../../library/functions.rst:375 +#: ../../library/functions.rst:372 #, fuzzy msgid "" "When converting from a string, the string must not contain whitespace around " @@ -911,24 +905,24 @@ msgstr "" "``complex('1+2j')`` 是合法的，但 ``complex('1 + 2j')`` 會觸發 :exc:" "`ValueError` 異常。" -#: ../../library/functions.rst:380 +#: ../../library/functions.rst:377 #, fuzzy msgid "The complex type is described in :ref:`typesnumeric`." msgstr ":ref:`typesnumeric` 描述了複數型別。" -#: ../../library/functions.rst:382 ../../library/functions.rst:672 -#: ../../library/functions.rst:888 +#: ../../library/functions.rst:379 ../../library/functions.rst:669 +#: ../../library/functions.rst:885 #, fuzzy msgid "Grouping digits with underscores as in code literals is allowed." msgstr "您可以使用下劃線將程式碼文字中的數字進行分組。" -#: ../../library/functions.rst:385 +#: ../../library/functions.rst:382 msgid "" "Falls back to :meth:`__index__` if :meth:`__complex__` and :meth:`__float__` " "are not defined." msgstr "" -#: ../../library/functions.rst:392 +#: ../../library/functions.rst:389 #, fuzzy msgid "" "This is a relative of :func:`setattr`. The arguments are an object and a " @@ -940,7 +934,7 @@ msgstr "" "屬性。如果物件允許，該函式將刪除指定的屬性。例如 ``delattr(x, 'foobar')`` 等" "價於 ``del x.foobar`` 。" -#: ../../library/functions.rst:404 +#: ../../library/functions.rst:401 #, fuzzy msgid "" "Create a new dictionary. The :class:`dict` object is the dictionary class. " @@ -949,7 +943,7 @@ msgstr "" "建立一個新的字典。:class:`dict` 物件是一個字典類。參見 :class:`dict` 和 :ref:" "`typesmapping` 瞭解這個類。" -#: ../../library/functions.rst:407 +#: ../../library/functions.rst:404 #, fuzzy msgid "" "For other containers see the built-in :class:`list`, :class:`set`, and :" @@ -958,7 +952,7 @@ msgstr "" "其他容器型別，請參見內建的 :class:`list`、:class:`set` 和 :class:`tuple` 類，" "以及 :mod:`collections` 模組。" -#: ../../library/functions.rst:413 +#: ../../library/functions.rst:410 #, fuzzy msgid "" "Without arguments, return the list of names in the current local scope. " @@ -968,7 +962,7 @@ msgstr "" "如果沒有實參，則返回當前本地作用域中的名稱列表。如果有實參，它會嘗試返回該物" "件的有效屬性列表。" -#: ../../library/functions.rst:416 +#: ../../library/functions.rst:413 #, fuzzy msgid "" "If the object has a method named :meth:`__dir__`, this method will be called " @@ -980,7 +974,7 @@ msgstr "" "個屬性列表。這允許實現自定義 :func:`__getattr__` 或 :func:`__getattribute__` " "函式的物件能夠自定義 :func:`dir` 來報告它們的屬性。" -#: ../../library/functions.rst:421 +#: ../../library/functions.rst:418 #, fuzzy msgid "" "If the object does not provide :meth:`__dir__`, the function tries its best " @@ -993,7 +987,7 @@ msgstr "" "__dict__` 屬性和型別物件收集資訊。結果列表並不總是完整的，如果物件有自定義 :" "func:`__getattr__`，那結果可能不準確。" -#: ../../library/functions.rst:426 +#: ../../library/functions.rst:423 #, fuzzy msgid "" "The default :func:`dir` mechanism behaves differently with different types " @@ -1003,14 +997,14 @@ msgstr "" "預設的 :func:`dir` 機制對不同型別的物件行為不同，它會試圖返回最相關而不是最全" "的資訊：" -#: ../../library/functions.rst:430 +#: ../../library/functions.rst:427 #, fuzzy msgid "" "If the object is a module object, the list contains the names of the " "module's attributes." msgstr "如果物件是模組物件，則列表包含模組的屬性名稱。" -#: ../../library/functions.rst:433 +#: ../../library/functions.rst:430 #, fuzzy msgid "" "If the object is a type or class object, the list contains the names of its " @@ -1019,7 +1013,7 @@ msgstr "" "如果物件是型別或類物件，則列表包含它們的屬性名稱，並且遞迴查詢所有基類的屬" "性。" -#: ../../library/functions.rst:436 +#: ../../library/functions.rst:433 #, fuzzy msgid "" "Otherwise, the list contains the object's attributes' names, the names of " @@ -1029,12 +1023,12 @@ msgstr "" "否則，列表包含物件的屬性名稱，它的類屬性名稱，並且遞迴查詢它的類的所有基類的" "屬性。" -#: ../../library/functions.rst:440 +#: ../../library/functions.rst:437 #, fuzzy msgid "The resulting list is sorted alphabetically. For example:" msgstr "返回的列表按字母表排序。例如：" -#: ../../library/functions.rst:459 +#: ../../library/functions.rst:456 #, fuzzy msgid "" "Because :func:`dir` is supplied primarily as a convenience for use at an " @@ -1047,7 +1041,7 @@ msgstr "" "字集合，而不是試圖保證結果的嚴格性或一致性，它具體的行為也可能在不同版本之間" "改變。例如，當實參是一個類時，metaclass 的屬性不包含在結果列表中。" -#: ../../library/functions.rst:469 +#: ../../library/functions.rst:466 #, fuzzy msgid "" "Take two (non-complex) numbers as arguments and return a pair of numbers " @@ -1065,7 +1059,7 @@ msgstr "" "能會比 1 小。在任何情況下， ``q * b + a % b`` 和 *a* 基本相等；如果 ``a % " "b`` 非零，它的符號和 *b* 一樣，並且 ``0 <= abs(a % b) < abs(b)`` 。" -#: ../../library/functions.rst:481 +#: ../../library/functions.rst:478 #, fuzzy msgid "" "Return an enumerate object. *iterable* must be a sequence, an :term:" @@ -1079,12 +1073,12 @@ msgstr "" "返回一個元組，裡面包含一個計數值（從 *start* 開始，預設為 0）和通過迭代 " "*iterable* 獲得的值。" -#: ../../library/functions.rst:493 +#: ../../library/functions.rst:490 #, fuzzy msgid "Equivalent to::" msgstr "等價於::" -#: ../../library/functions.rst:504 +#: ../../library/functions.rst:501 #, fuzzy msgid "" "The arguments are a string and optional globals and locals. If provided, " @@ -1094,7 +1088,7 @@ msgstr "" "實參是一個字串，以及可選的 globals 和 locals。*globals* 實參必須是一個字典。" "*locals* 可以是任何對映物件。" -#: ../../library/functions.rst:508 +#: ../../library/functions.rst:505 #, fuzzy msgid "" "The *expression* argument is parsed and evaluated as a Python expression " @@ -1119,13 +1113,13 @@ msgstr "" "字典。如果兩個字典變數都被省略了，則在 :func:`eval` 被呼叫的環境中執行表示" "式。函式的返回值是表示式執行的結果。語法錯誤會產生異常。如：" -#: ../../library/functions.rst:523 +#: ../../library/functions.rst:520 msgid "" "The return value is the result of the evaluated expression. Syntax errors " "are reported as exceptions. Example:" msgstr "" -#: ../../library/functions.rst:530 +#: ../../library/functions.rst:527 #, fuzzy msgid "" "This function can also be used to execute arbitrary code objects (such as " @@ -1137,7 +1131,7 @@ msgstr "" "下，引數是程式碼物件，而不是字串。如果編譯該物件時的 *mode* 實參是 " "``'exec'`` 那麼 :func:`eval` 返回值為 ``None`` 。" -#: ../../library/functions.rst:535 +#: ../../library/functions.rst:532 #, fuzzy msgid "" "Hints: dynamic execution of statements is supported by the :func:`exec` " @@ -1149,13 +1143,13 @@ msgstr "" "函式各自返回當前的全域性和本地字典，因此您可以將它們傳遞給 :func:`eval` 或 :" "func:`exec` 來使用。" -#: ../../library/functions.rst:540 +#: ../../library/functions.rst:537 msgid "" "If the given source is a string, then leading and trailing spaces and tabs " "are stripped." msgstr "" -#: ../../library/functions.rst:543 +#: ../../library/functions.rst:540 #, fuzzy msgid "" "See :func:`ast.literal_eval` for a function that can safely evaluate strings " @@ -1164,19 +1158,19 @@ msgstr "" "另外可以參閱 :func:`ast.literal_eval`，該函式可以安全執行僅包含文字的表示式字" "串。" -#: ../../library/functions.rst:546 ../../library/functions.rst:582 +#: ../../library/functions.rst:543 ../../library/functions.rst:579 msgid "" "Raises an :ref:`auditing event ` ``exec`` with argument " "``code_object``." msgstr "" -#: ../../library/functions.rst:548 ../../library/functions.rst:584 +#: ../../library/functions.rst:545 ../../library/functions.rst:581 msgid "" "Raises an :ref:`auditing event ` ``exec`` with the code object as " "the argument. Code compilation events may also be raised." msgstr "" -#: ../../library/functions.rst:555 +#: ../../library/functions.rst:552 #, fuzzy msgid "" "This function supports dynamic execution of Python code. *object* must be " @@ -1196,7 +1190,7 @@ msgstr "" "`exec` 函式的程式碼的上下文中，:keyword:`return` 和 :keyword:`yield` 語句也不" "能在函式定義之外使用。該函式返回值是 ``None`` 。" -#: ../../library/functions.rst:566 +#: ../../library/functions.rst:563 #, fuzzy msgid "" "In all cases, if the optional parts are omitted, the code is executed in the " @@ -1216,7 +1210,7 @@ msgstr "" "是相同的字典。如果 exec 有兩個不同的 *globals* 和 *locals* 物件，程式碼就像嵌" "入在類定義中一樣執行。" -#: ../../library/functions.rst:576 +#: ../../library/functions.rst:573 #, fuzzy msgid "" "If the *globals* dictionary does not contain a value for the key " @@ -1230,7 +1224,7 @@ msgstr "" "以通過將自己的 ``__builtins__`` 字典插入到 *globals* 中來控制可以使用哪些內建" "程式碼。" -#: ../../library/functions.rst:589 +#: ../../library/functions.rst:586 #, fuzzy msgid "" "The built-in functions :func:`globals` and :func:`locals` return the current " @@ -1240,7 +1234,7 @@ msgstr "" "內建 :func:`globals` 和 :func:`locals` 函式各自返回當前的全域性和本地字典，因" "此可以將它們傳遞給 :func:`exec` 的第二個和第三個實參。" -#: ../../library/functions.rst:595 +#: ../../library/functions.rst:592 #, fuzzy msgid "" "The default *locals* act as described for function :func:`locals` below: " @@ -1252,7 +1246,7 @@ msgstr "" "預設的 *locals* 字典。如果您想在 :func:`exec` 函式返回時知道程式碼對 " "*locals* 的變動，請明確地傳遞 *locals* 字典。" -#: ../../library/functions.rst:603 +#: ../../library/functions.rst:600 #, fuzzy msgid "" "Construct an iterator from those elements of *iterable* for which *function* " @@ -1266,7 +1260,7 @@ msgstr "" "是 ``None`` ，則會假設它是一個身份函式，即 *iterable* 中所有返回假的元素會被" "移除。" -#: ../../library/functions.rst:609 +#: ../../library/functions.rst:606 #, fuzzy msgid "" "Note that ``filter(function, iterable)`` is equivalent to the generator " @@ -1278,7 +1272,7 @@ msgstr "" "不是 ``None`` 的時候為 ``(item for item in iterable if function(item))``；" "function 是 ``None`` 的時候為 ``(item for item in iterable if item)`` 。" -#: ../../library/functions.rst:614 +#: ../../library/functions.rst:611 #, fuzzy msgid "" "See :func:`itertools.filterfalse` for the complementary function that " @@ -1287,12 +1281,12 @@ msgstr "" "請參閱 :func:`itertools.filterfalse` 瞭解，只有 *function* 返回 false 時才選" "取 *iterable* 中元素的補充函式。" -#: ../../library/functions.rst:624 +#: ../../library/functions.rst:621 #, fuzzy msgid "Return a floating point number constructed from a number or string *x*." msgstr "返回從數字或字串 *x* 生成的浮點數。" -#: ../../library/functions.rst:626 +#: ../../library/functions.rst:623 #, fuzzy msgid "" "If the argument is a string, it should contain a decimal number, optionally " @@ -1308,7 +1302,7 @@ msgstr "" "參也可以是 NaN（非數字）、正負無窮大的字串。確切地說，除去首尾的空格後，輸入" "必須遵循以下語法：" -#: ../../library/functions.rst:641 +#: ../../library/functions.rst:638 #, fuzzy msgid "" "Here ``floatnumber`` is the form of a Python floating-point literal, " @@ -1319,7 +1313,7 @@ msgstr "" "這裡， ``floatnumber`` 是 Python 浮點數的字串形式，詳見 :ref:`floating`。字母" "大小寫都可以，例如，“inf”、“Inf”、“INFINITY”、“iNfINity” 都可以表示正無窮大。" -#: ../../library/functions.rst:646 +#: ../../library/functions.rst:643 #, fuzzy msgid "" "Otherwise, if the argument is an integer or a floating point number, a " @@ -1331,7 +1325,7 @@ msgstr "" "內）的浮點數。如果實參在 Python 浮點精度範圍外，則會觸發 :exc:" "`OverflowError`。" -#: ../../library/functions.rst:651 +#: ../../library/functions.rst:648 #, fuzzy msgid "" "For a general Python object ``x``, ``float(x)`` delegates to ``x." @@ -1340,26 +1334,26 @@ msgid "" msgstr "" "對於一般的 Python 物件 ``x`` ， ``float(x)`` 指派給 ``x.__float__()`` 。" -#: ../../library/functions.rst:655 +#: ../../library/functions.rst:652 #, fuzzy msgid "If no argument is given, ``0.0`` is returned." msgstr "如果沒有實參，則返回 ``0.0`` 。" -#: ../../library/functions.rst:657 +#: ../../library/functions.rst:654 #, fuzzy msgid "Examples::" msgstr "例如::" -#: ../../library/functions.rst:670 +#: ../../library/functions.rst:667 #, fuzzy msgid "The float type is described in :ref:`typesnumeric`." msgstr ":ref:`typesnumeric` 描述了浮點型別。" -#: ../../library/functions.rst:678 +#: ../../library/functions.rst:675 msgid "Falls back to :meth:`__index__` if :meth:`__float__` is not defined." msgstr "" -#: ../../library/functions.rst:688 +#: ../../library/functions.rst:685 #, fuzzy msgid "" "Convert a *value* to a \"formatted\" representation, as controlled by " @@ -1371,7 +1365,7 @@ msgstr "" "於 *value* 實參的型別，但是大多數內建型別使用標準格式化語法：:ref:" "`formatspec`。" -#: ../../library/functions.rst:693 +#: ../../library/functions.rst:690 #, fuzzy msgid "" "The default *format_spec* is an empty string which usually gives the same " @@ -1380,7 +1374,7 @@ msgstr "" "預設的 *format_spec* 是一個空字串，它通常和呼叫 :func:`str(value)` 的結" "果相同。" -#: ../../library/functions.rst:696 +#: ../../library/functions.rst:693 #, fuzzy msgid "" "A call to ``format(value, format_spec)`` is translated to ``type(value)." @@ -1395,7 +1389,7 @@ msgstr "" "不會呼叫。如果搜尋到 :mod:`object` 有這個方法但 *format_spec* 不為空，" "*format_spec* 或返回值不是字串，會觸發 :exc:`TypeError` 異常。" -#: ../../library/functions.rst:703 +#: ../../library/functions.rst:700 #, fuzzy msgid "" "``object().__format__(format_spec)`` raises :exc:`TypeError` if " @@ -1404,7 +1398,7 @@ msgstr "" "當 *format_spec* 不是空字串時， ``object().__format__(format_spec)`` 會觸" "發 :exc:`TypeError`。" -#: ../../library/functions.rst:712 +#: ../../library/functions.rst:709 #, fuzzy msgid "" "Return a new :class:`frozenset` object, optionally with elements taken from " @@ -1415,7 +1409,7 @@ msgstr "" "``frozenset`` 是一個內建的類。有關此類的文件，請參閱 :class:`frozenset` 和 :" "ref:`types-set`。" -#: ../../library/functions.rst:716 +#: ../../library/functions.rst:713 #, fuzzy msgid "" "For other containers see the built-in :class:`set`, :class:`list`, :class:" @@ -1424,7 +1418,7 @@ msgstr "" "請參閱內建的 :class:`set`、:class:`list`、:class:`tuple` 和 :class:`dict` " "類，以及 :mod:`collections` 模組來了解其它的容器。" -#: ../../library/functions.rst:723 +#: ../../library/functions.rst:720 #, fuzzy msgid "" "Return the value of the named attribute of *object*. *name* must be a " @@ -1438,7 +1432,7 @@ msgstr "" "屬性的值。例如， ``getattr(x, 'foobar')`` 等同於 ``x.foobar``。如果指定的屬性" "不存在，且提供了 *default* 值，則返回它，否則觸發 :exc:`AttributeError`。" -#: ../../library/functions.rst:731 +#: ../../library/functions.rst:728 msgid "" "Since :ref:`private name mangling ` happens at " "compilation time, one must manually mangle a private attribute's (attributes " @@ -1446,7 +1440,7 @@ msgid "" "`getattr`." msgstr "" -#: ../../library/functions.rst:739 +#: ../../library/functions.rst:736 #, fuzzy msgid "" "Return a dictionary representing the current global symbol table. This is " @@ -1457,7 +1451,7 @@ msgstr "" "返回表示當前全域性符號表的字典。這總是當前模組的字典（在函式或方法中，不是呼" "叫它的模組，而是定義它的模組）。" -#: ../../library/functions.rst:746 +#: ../../library/functions.rst:743 #, fuzzy msgid "" "The arguments are an object and a string. The result is ``True`` if the " @@ -1469,7 +1463,7 @@ msgstr "" "否則返回 ``False``。（此功能是通過呼叫 ``getattr(object, name)`` 看是否有 :" "exc:`AttributeError` 異常來實現的。）" -#: ../../library/functions.rst:754 +#: ../../library/functions.rst:751 #, fuzzy msgid "" "Return the hash value of the object (if it has one). Hash values are " @@ -1481,7 +1475,7 @@ msgstr "" "速比較字典的鍵。相同大小的數字變數有相同的雜湊值（即使它們型別不同，如 1 和 " "1.0）。" -#: ../../library/functions.rst:761 +#: ../../library/functions.rst:758 #, fuzzy msgid "" "For objects with custom :meth:`__hash__` methods, note that :func:`hash` " @@ -1491,7 +1485,7 @@ msgstr "" "如果物件實現了自己的 :meth:`__hash__` 方法，請注意，:func:`hash` 根據機器的字" "長來截斷返回值。另請參閱 :meth:`__hash__`。" -#: ../../library/functions.rst:767 +#: ../../library/functions.rst:764 #, fuzzy msgid "" "Invoke the built-in help system. (This function is intended for interactive " @@ -1506,7 +1500,7 @@ msgstr "" "文件主題中搜索該字串，並在控制檯上列印幫助資訊。如果實參是其他任意物件，則會" "生成該物件的幫助頁。" -#: ../../library/functions.rst:774 +#: ../../library/functions.rst:771 msgid "" "Note that if a slash(/) appears in the parameter list of a function when " "invoking :func:`help`, it means that the parameters prior to the slash are " @@ -1514,13 +1508,13 @@ msgid "" "parameters `." msgstr "" -#: ../../library/functions.rst:779 +#: ../../library/functions.rst:776 #, fuzzy msgid "" "This function is added to the built-in namespace by the :mod:`site` module." msgstr "該函式通過 :mod:`site` 模組加入到內建名稱空間。" -#: ../../library/functions.rst:781 +#: ../../library/functions.rst:778 #, fuzzy msgid "" "Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures " @@ -1528,7 +1522,7 @@ msgid "" msgstr "" ":mod:`pydoc` 和 :mod:`inspect` 的變更使得可呼叫物件的簽名信息更加全面和一致。" -#: ../../library/functions.rst:788 +#: ../../library/functions.rst:785 #, fuzzy msgid "" "Convert an integer number to a lowercase hexadecimal string prefixed with " @@ -1538,7 +1532,7 @@ msgstr "" "將整數轉換為以“0x”為字首的小寫十六進位制字串。如果 *x* 不是 Python :class:" "`int` 物件，則必須定義返回整數的 :meth:`__index__` 方法。一些例子：" -#: ../../library/functions.rst:797 +#: ../../library/functions.rst:794 #, fuzzy msgid "" "If you want to convert an integer number to an uppercase or lower " @@ -1548,21 +1542,21 @@ msgstr "" "如果要將整數轉換為大寫或小寫的十六進位制字串，並可選擇有無“0x”字首，則可以使" "用如下方法：" -#: ../../library/functions.rst:809 +#: ../../library/functions.rst:806 #, fuzzy msgid "" "See also :func:`int` for converting a hexadecimal string to an integer using " "a base of 16." msgstr "另請參閱 :func:`int` 將十六進位制字串轉換為以 16 為基數的整數。" -#: ../../library/functions.rst:814 +#: ../../library/functions.rst:811 #, fuzzy msgid "" "To obtain a hexadecimal string representation for a float, use the :meth:" "`float.hex` method." msgstr "如果要獲取浮點數的十六進位制字串形式，請使用 :meth:`float.hex` 方法。" -#: ../../library/functions.rst:820 +#: ../../library/functions.rst:817 #, fuzzy msgid "" "Return the \"identity\" of an object. This is an integer which is " @@ -1573,13 +1567,13 @@ msgstr "" "返回物件的“標識值”。該值是一個整數，在此物件的生命週期中保證是唯一且恆定的。" "兩個生命期不重疊的物件可能具有相同的 :func:`id` 值。" -#: ../../library/functions.rst:827 +#: ../../library/functions.rst:824 msgid "" "Raises an :ref:`auditing event ` ``builtins.id`` with argument " "``id``." msgstr "" -#: ../../library/functions.rst:832 +#: ../../library/functions.rst:829 #, fuzzy msgid "" "If the *prompt* argument is present, it is written to standard output " @@ -1591,7 +1585,7 @@ msgstr "" "輸入中讀取一行，將其轉換為字串（除了末尾的換行符）並返回。當讀取到 EOF 時，則" "觸發 :exc:`EOFError`。例如::" -#: ../../library/functions.rst:842 +#: ../../library/functions.rst:839 #, fuzzy msgid "" "If the :mod:`readline` module was loaded, then :func:`input` will use it to " @@ -1600,31 +1594,31 @@ msgstr "" "如果載入了 :mod:`readline` 模組，:func:`input` 將使用它來提供複雜的行編輯和歷" "史記錄功能。" -#: ../../library/functions.rst:845 +#: ../../library/functions.rst:842 msgid "" "Raises an :ref:`auditing event ` ``builtins.input`` with argument " "``prompt``." msgstr "" -#: ../../library/functions.rst:847 +#: ../../library/functions.rst:844 msgid "" "Raises an :ref:`auditing event ` ``builtins.input`` with argument " "``prompt`` before reading input" msgstr "" -#: ../../library/functions.rst:850 +#: ../../library/functions.rst:847 msgid "" "Raises an :ref:`auditing event ` ``builtins.input/result`` with " "argument ``result``." msgstr "" -#: ../../library/functions.rst:852 +#: ../../library/functions.rst:849 msgid "" "Raises an auditing event ``builtins.input/result`` with the result after " "successfully reading input." msgstr "" -#: ../../library/functions.rst:859 +#: ../../library/functions.rst:856 #, fuzzy msgid "" "Return an integer object constructed from a number or string *x*, or return " @@ -1637,7 +1631,7 @@ msgstr "" "果 *x* 定義了 :meth:`__int__`，``int(x)`` 返回 ``x.__int__()`` 。如果 *x* 定" "義了 :meth:`__trunc__`，它返回 ``x.__trunc__()`` 。對於浮點數，它向零舍入。" -#: ../../library/functions.rst:866 +#: ../../library/functions.rst:863 #, fuzzy msgid "" "If *x* is not a number or if *base* is given, then *x* must be a string, :" @@ -1663,12 +1657,12 @@ msgstr "" "以 ``int('010', 0)`` 是非法的，但 ``int('010')`` 和 ``int('010', 8)`` 是合法" "的。" -#: ../../library/functions.rst:879 +#: ../../library/functions.rst:876 #, fuzzy msgid "The integer type is described in :ref:`typesnumeric`." msgstr "整數型別定義請參閱 :ref:`typesnumeric` 。" -#: ../../library/functions.rst:881 +#: ../../library/functions.rst:878 #, fuzzy msgid "" "If *base* is not an instance of :class:`int` and the *base* object has a :" @@ -1681,11 +1675,11 @@ msgstr "" "`base.__int__ ` 而不是 :meth:`base.__index__ `。" -#: ../../library/functions.rst:894 +#: ../../library/functions.rst:891 msgid "Falls back to :meth:`__index__` if :meth:`__int__` is not defined." msgstr "" -#: ../../library/functions.rst:900 +#: ../../library/functions.rst:897 #, fuzzy msgid "" "Return ``True`` if the *object* argument is an instance of the *classinfo* " @@ -1703,11 +1697,11 @@ msgstr "" "組，如果 *object* 是其中的任何一個的例項則返回 true。 如果 *classinfo* 既不是" "型別，也不是型別元組或型別的遞迴元組，那麼會觸發 :exc:`TypeError` 異常。" -#: ../../library/functions.rst:910 ../../library/functions.rst:923 +#: ../../library/functions.rst:907 ../../library/functions.rst:920 msgid "*classinfo* can be a :ref:`types-union`." msgstr "" -#: ../../library/functions.rst:916 +#: ../../library/functions.rst:913 #, fuzzy msgid "" "Return ``True`` if *class* is a subclass (direct, indirect, or :term:" @@ -1721,14 +1715,14 @@ msgstr "" "class>` 的），則返回 true。*classinfo* 可以是類物件的元組，此時 *classinfo* " "中的每個元素都會被檢查。其他情況，會觸發 :exc:`TypeError` 異常。" -#: ../../library/functions.rst:929 +#: ../../library/functions.rst:926 #, fuzzy msgid "" "Return an :term:`iterator` object. The first argument is interpreted very " "differently depending on the presence of the second argument. Without a " -"second argument, *object* must be a collection object which supports the " -"iteration protocol (the :meth:`__iter__` method), or it must support the " -"sequence protocol (the :meth:`__getitem__` method with integer arguments " +"second argument, *object* must be a collection object which supports the :" +"term:`iterable` protocol (the :meth:`__iter__` method), or it must support " +"the sequence protocol (the :meth:`__getitem__` method with integer arguments " "starting at ``0``). If it does not support either of those protocols, :exc:" "`TypeError` is raised. If the second argument, *sentinel*, is given, then " "*object* must be a callable object. The iterator created in this case will " @@ -1745,19 +1739,19 @@ msgstr "" "會不帶實參地呼叫 *object*；如果返回的結果是 *sentinel* 則觸發 :exc:" "`StopIteration`，否則返回呼叫結果。" -#: ../../library/functions.rst:942 +#: ../../library/functions.rst:939 #, fuzzy msgid "See also :ref:`typeiter`." msgstr "另請參閱 :ref:`typeiter`。" -#: ../../library/functions.rst:944 +#: ../../library/functions.rst:941 msgid "" "One useful application of the second form of :func:`iter` is to build a " "block-reader. For example, reading fixed-width blocks from a binary database " "file until the end of file is reached::" msgstr "" -#: ../../library/functions.rst:956 +#: ../../library/functions.rst:953 #, fuzzy msgid "" "Return the length (the number of items) of an object. The argument may be a " @@ -1767,13 +1761,13 @@ msgstr "" "返回物件的長度（元素個數）。實參可以是序列（如 string、bytes、tuple、list 或 " "range 等）或集合（如 dictionary、set 或 frozen set 等）。" -#: ../../library/functions.rst:962 +#: ../../library/functions.rst:959 msgid "" "``len`` raises :exc:`OverflowError` on lengths larger than :data:`sys." "maxsize`, such as :class:`range(2 ** 100) `." msgstr "" -#: ../../library/functions.rst:970 +#: ../../library/functions.rst:967 #, fuzzy msgid "" "Rather than being a function, :class:`list` is actually a mutable sequence " @@ -1782,7 +1776,7 @@ msgstr "" "除了是函式，:class:`list` 也是可變序列型別，詳情請參閱 :ref:`typesseq-list` " "和 :ref:`typesseq`。" -#: ../../library/functions.rst:976 +#: ../../library/functions.rst:973 #, fuzzy msgid "" "Update and return a dictionary representing the current local symbol table. " @@ -1793,7 +1787,7 @@ msgstr "" "更新並返回表示當前本地符號表的字典。在函式塊而不是類塊中呼叫 :func:`locals` " "時會返回自由變數。" -#: ../../library/functions.rst:982 +#: ../../library/functions.rst:979 #, fuzzy msgid "" "The contents of this dictionary should not be modified; changes may not " @@ -1801,7 +1795,7 @@ msgid "" msgstr "" "不要更改此字典的內容；更改不會影響直譯器使用的區域性變數或自由變數的值。" -#: ../../library/functions.rst:987 +#: ../../library/functions.rst:984 #, fuzzy msgid "" "Return an iterator that applies *function* to every item of *iterable*, " @@ -1816,14 +1810,14 @@ msgstr "" "行獲取的元素。當有多個迭代器時，最短的迭代器耗盡則整個迭代結束。如果函式的輸" "入已經是元組實參，請參閱 :func:`itertools.starmap`。" -#: ../../library/functions.rst:998 +#: ../../library/functions.rst:995 #, fuzzy msgid "" "Return the largest item in an iterable or the largest of two or more " "arguments." msgstr "返回可迭代物件中最大的元素，或者返回兩個及以上實參中最大的。" -#: ../../library/functions.rst:1001 +#: ../../library/functions.rst:998 #, fuzzy msgid "" "If one positional argument is provided, it should be an :term:`iterable`. " @@ -1834,7 +1828,7 @@ msgstr "" "件中最大的元素；如果提供了兩個及以上的 positional 實參，則返回最大的 " "positional 實參。" -#: ../../library/functions.rst:1006 ../../library/functions.rst:1043 +#: ../../library/functions.rst:1003 ../../library/functions.rst:1040 #, fuzzy msgid "" "There are two optional keyword-only arguments. The *key* argument specifies " @@ -1847,7 +1841,7 @@ msgstr "" "`list.sort` 的。*default* 實參是當可迭代物件為空時返回的值。如果可迭代物件為" "空，並且沒有給 *default* ，則會觸發 :exc:`ValueError`。" -#: ../../library/functions.rst:1012 +#: ../../library/functions.rst:1009 #, fuzzy msgid "" "If multiple items are maximal, the function returns the first one " @@ -1859,16 +1853,16 @@ msgstr "" "``sorted(iterable, key=keyfunc, reverse=True)[0]`` 和 ``heapq.nlargest(1, " "iterable, key=keyfunc)`` 保持一致。" -#: ../../library/functions.rst:1017 ../../library/functions.rst:1054 +#: ../../library/functions.rst:1014 ../../library/functions.rst:1051 #, fuzzy msgid "The *default* keyword-only argument." msgstr "keyword-only 實參 *default* 。" -#: ../../library/functions.rst:1020 ../../library/functions.rst:1057 +#: ../../library/functions.rst:1017 ../../library/functions.rst:1054 msgid "The *key* can be ``None``." msgstr "" -#: ../../library/functions.rst:1028 +#: ../../library/functions.rst:1025 #, fuzzy msgid "" "Return a \"memory view\" object created from the given argument. See :ref:" @@ -1877,14 +1871,14 @@ msgstr "" "返回由給定實參建立的“記憶體檢視”物件。有關詳細資訊，請參閱 :ref:" "`typememoryview`。" -#: ../../library/functions.rst:1035 +#: ../../library/functions.rst:1032 #, fuzzy msgid "" "Return the smallest item in an iterable or the smallest of two or more " "arguments." msgstr "返回可迭代物件中最小的元素，或者返回兩個及以上實參中最小的。" -#: ../../library/functions.rst:1038 +#: ../../library/functions.rst:1035 #, fuzzy msgid "" "If one positional argument is provided, it should be an :term:`iterable`. " @@ -1895,7 +1889,7 @@ msgstr "" "最小的元素；如果提供了兩個及以上的 positional 實參，則返回最小的 positional " "實參。" -#: ../../library/functions.rst:1049 +#: ../../library/functions.rst:1046 #, fuzzy msgid "" "If multiple items are minimal, the function returns the first one " @@ -1907,17 +1901,17 @@ msgstr "" "``sorted(iterable, key=keyfunc)[0]`` 和 ``heapq.nsmallest(1, iterable, " "key=keyfunc)`` 保持一致。" -#: ../../library/functions.rst:1063 +#: ../../library/functions.rst:1060 #, fuzzy msgid "" -"Retrieve the next item from the *iterator* by calling its :meth:`~iterator." -"__next__` method. If *default* is given, it is returned if the iterator is " -"exhausted, otherwise :exc:`StopIteration` is raised." +"Retrieve the next item from the :term:`iterator` by calling its :meth:" +"`~iterator.__next__` method. If *default* is given, it is returned if the " +"iterator is exhausted, otherwise :exc:`StopIteration` is raised." msgstr "" "通過呼叫 *iterator* 的 :meth:`~iterator.__next__` 方法獲取下一個元素。如果迭" "代器耗盡，則返回給定的 *default*，如果沒有預設值則觸發 :exc:`StopIteration`。" -#: ../../library/functions.rst:1070 +#: ../../library/functions.rst:1067 #, fuzzy msgid "" "Return a new featureless object. :class:`object` is a base for all classes. " @@ -1927,7 +1921,7 @@ msgstr "" "返回一個沒有特徵的新物件。:class:`object` 是所有類的基類。它具有所有 Python " "類例項的通用方法。這個函式不接受任何實參。" -#: ../../library/functions.rst:1076 +#: ../../library/functions.rst:1073 #, fuzzy msgid "" ":class:`object` does *not* have a :attr:`~object.__dict__`, so you can't " @@ -1936,7 +1930,7 @@ msgstr "" "由於 :class:`object` 沒有 :attr:`~object.__dict__`，因此無法將任意屬性賦給 :" "class:`object` 的例項。" -#: ../../library/functions.rst:1082 +#: ../../library/functions.rst:1079 #, fuzzy msgid "" "Convert an integer number to an octal string prefixed with \"0o\". The " @@ -1948,7 +1942,7 @@ msgstr "" "式。如果 *x* 不是 Python 的 :class:`int` 物件，那它需要定義 :meth:" "`__index__` 方法返回一個整數。一些例子：" -#: ../../library/functions.rst:1092 +#: ../../library/functions.rst:1089 #, fuzzy msgid "" "If you want to convert an integer number to an octal string either with the " @@ -1956,7 +1950,7 @@ msgid "" msgstr "" "如果要將整數轉換為八進位制字串，並可選擇有無“0o”字首，則可以使用如下方法：" -#: ../../library/functions.rst:1109 +#: ../../library/functions.rst:1106 #, fuzzy msgid "" "Open *file* and return a corresponding :term:`file object`. If the file " @@ -1966,7 +1960,7 @@ msgstr "" "開啟 *file* 並返回對應的 :term:`file object`。如果該檔案不能開啟，則觸發 :" "exc:`OSError`。" -#: ../../library/functions.rst:1113 +#: ../../library/functions.rst:1110 #, fuzzy msgid "" "*file* is a :term:`path-like object` giving the pathname (absolute or " @@ -1979,7 +1973,7 @@ msgstr "" "term:`path-like object`；也可能是要被封裝的檔案描述符的數字。（如果是檔案描述" "符，它會隨著返回的 I/O 物件關閉而關閉，除非 *closefd* 是 ``False`` 。）" -#: ../../library/functions.rst:1119 +#: ../../library/functions.rst:1116 #, fuzzy msgid "" "*mode* is an optional string that specifies the mode in which the file is " @@ -2001,79 +1995,79 @@ msgstr "" "getpreferredencoding(False)`` 來獲取本地編碼。（要讀取和寫入原始位元組，請使" "用二進位制模式並不要指定 *encoding*。）可用的模式有：" -#: ../../library/functions.rst:1136 +#: ../../library/functions.rst:1133 #, fuzzy msgid "Character" msgstr "字元" -#: ../../library/functions.rst:1136 +#: ../../library/functions.rst:1133 #, fuzzy msgid "Meaning" msgstr "意義" -#: ../../library/functions.rst:1138 +#: ../../library/functions.rst:1135 msgid "``'r'``" msgstr "``'r'``" -#: ../../library/functions.rst:1138 +#: ../../library/functions.rst:1135 #, fuzzy msgid "open for reading (default)" msgstr "讀取（預設）" -#: ../../library/functions.rst:1139 +#: ../../library/functions.rst:1136 msgid "``'w'``" msgstr "``'w'``" -#: ../../library/functions.rst:1139 +#: ../../library/functions.rst:1136 #, fuzzy msgid "open for writing, truncating the file first" msgstr "写入，并先截断文件" -#: ../../library/functions.rst:1140 +#: ../../library/functions.rst:1137 msgid "``'x'``" msgstr "``'x'``" -#: ../../library/functions.rst:1140 +#: ../../library/functions.rst:1137 #, fuzzy msgid "open for exclusive creation, failing if the file already exists" msgstr "排它性创建，如果文件已存在则失败" -#: ../../library/functions.rst:1141 +#: ../../library/functions.rst:1138 msgid "``'a'``" msgstr "``'a'``" -#: ../../library/functions.rst:1141 +#: ../../library/functions.rst:1138 #, fuzzy msgid "open for writing, appending to the end of file if it exists" msgstr "写入，如果文件存在则在末尾追加" -#: ../../library/functions.rst:1142 +#: ../../library/functions.rst:1139 msgid "``'b'``" msgstr "``'b'``" -#: ../../library/functions.rst:1142 +#: ../../library/functions.rst:1139 #, fuzzy msgid "binary mode" msgstr "二进制模式" -#: ../../library/functions.rst:1143 +#: ../../library/functions.rst:1140 msgid "``'t'``" msgstr "``'t'``" -#: ../../library/functions.rst:1143 +#: ../../library/functions.rst:1140 msgid "text mode (default)" msgstr "文字模式（預設）" -#: ../../library/functions.rst:1144 +#: ../../library/functions.rst:1141 msgid "``'+'``" msgstr "``'+'``" -#: ../../library/functions.rst:1144 +#: ../../library/functions.rst:1141 #, fuzzy msgid "open for updating (reading and writing)" msgstr "更新磁碟檔案（讀取並寫入）" -#: ../../library/functions.rst:1147 +#: ../../library/functions.rst:1144 #, fuzzy msgid "" "The default mode is ``'r'`` (open for reading text, a synonym of ``'rt'``). " @@ -2083,7 +2077,7 @@ msgstr "" "預設的模式是 ``'r'`` （開啟並讀取文字，同 ``'rt'`` ）。對於二進位制寫入， " "``'w+b'`` 模式開啟並把檔案截斷成 0 位元組； ``'r+b'`` 則不會截斷。" -#: ../../library/functions.rst:1151 +#: ../../library/functions.rst:1148 msgid "" "As mentioned in the :ref:`io-overview`, Python distinguishes between binary " "and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* " @@ -2094,7 +2088,7 @@ msgid "" "specified *encoding* if given." msgstr "" -#: ../../library/functions.rst:1159 +#: ../../library/functions.rst:1156 msgid "" "There is an additional mode character permitted, ``'U'``, which no longer " "has any effect, and is considered deprecated. It previously enabled :term:" @@ -2103,14 +2097,14 @@ msgid "" "parameter>` parameter for further details." msgstr "" -#: ../../library/functions.rst:1167 +#: ../../library/functions.rst:1164 msgid "" "Python doesn't depend on the underlying operating system's notion of text " "files; all the processing is done by Python itself, and is therefore " "platform-independent." msgstr "" -#: ../../library/functions.rst:1171 +#: ../../library/functions.rst:1168 msgid "" "*buffering* is an optional integer used to set the buffering policy. Pass 0 " "to switch buffering off (only allowed in binary mode), 1 to select line " @@ -2119,7 +2113,7 @@ msgid "" "given, the default buffering policy works as follows:" msgstr "" -#: ../../library/functions.rst:1177 +#: ../../library/functions.rst:1174 msgid "" "Binary files are buffered in fixed-size chunks; the size of the buffer is " "chosen using a heuristic trying to determine the underlying device's \"block " @@ -2127,14 +2121,14 @@ msgid "" "the buffer will typically be 4096 or 8192 bytes long." msgstr "" -#: ../../library/functions.rst:1182 +#: ../../library/functions.rst:1179 msgid "" "\"Interactive\" text files (files for which :meth:`~io.IOBase.isatty` " "returns ``True``) use line buffering. Other text files use the policy " "described above for binary files." msgstr "" -#: ../../library/functions.rst:1186 +#: ../../library/functions.rst:1183 msgid "" "*encoding* is the name of the encoding used to decode or encode the file. " "This should only be used in text mode. The default encoding is platform " @@ -2143,7 +2137,7 @@ msgid "" "module for the list of supported encodings." msgstr "" -#: ../../library/functions.rst:1193 +#: ../../library/functions.rst:1190 msgid "" "*errors* is an optional string that specifies how encoding and decoding " "errors are to be handled—this cannot be used in binary mode. A variety of " @@ -2152,25 +2146,25 @@ msgid "" "register_error` is also valid. The standard names include:" msgstr "" -#: ../../library/functions.rst:1201 +#: ../../library/functions.rst:1198 msgid "" "``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding " "error. The default value of ``None`` has the same effect." msgstr "" -#: ../../library/functions.rst:1205 +#: ../../library/functions.rst:1202 msgid "" "``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to " "data loss." msgstr "" -#: ../../library/functions.rst:1208 +#: ../../library/functions.rst:1205 msgid "" "``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted " "where there is malformed data." msgstr "" -#: ../../library/functions.rst:1211 +#: ../../library/functions.rst:1208 msgid "" "``'surrogateescape'`` will represent any incorrect bytes as low surrogate " "code units ranging from U+DC80 to U+DCFF. These surrogate code units will " @@ -2179,33 +2173,33 @@ msgid "" "an unknown encoding." msgstr "" -#: ../../library/functions.rst:1218 +#: ../../library/functions.rst:1215 msgid "" "``'xmlcharrefreplace'`` is only supported when writing to a file. Characters " "not supported by the encoding are replaced with the appropriate XML " "character reference ``&#nnn;``." msgstr "" -#: ../../library/functions.rst:1222 +#: ../../library/functions.rst:1219 msgid "" "``'backslashreplace'`` replaces malformed data by Python's backslashed " "escape sequences." msgstr "" -#: ../../library/functions.rst:1225 +#: ../../library/functions.rst:1222 msgid "" "``'namereplace'`` (also only supported when writing) replaces unsupported " "characters with ``\\N{...}`` escape sequences." msgstr "" -#: ../../library/functions.rst:1233 +#: ../../library/functions.rst:1230 msgid "" "*newline* controls how :term:`universal newlines` mode works (it only " "applies to text mode). It can be ``None``, ``''``, ``'\\n'``, ``'\\r'``, " "and ``'\\r\\n'``. It works as follows:" msgstr "" -#: ../../library/functions.rst:1237 +#: ../../library/functions.rst:1234 msgid "" "When reading input from the stream, if *newline* is ``None``, universal " "newlines mode is enabled. Lines in the input can end in ``'\\n'``, " @@ -2216,7 +2210,7 @@ msgid "" "given string, and the line ending is returned to the caller untranslated." msgstr "" -#: ../../library/functions.rst:1245 +#: ../../library/functions.rst:1242 msgid "" "When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " "characters written are translated to the system default line separator, :" @@ -2225,7 +2219,7 @@ msgid "" "characters written are translated to the given string." msgstr "" -#: ../../library/functions.rst:1251 +#: ../../library/functions.rst:1248 msgid "" "If *closefd* is ``False`` and a file descriptor rather than a filename was " "given, the underlying file descriptor will be kept open when the file is " @@ -2233,7 +2227,7 @@ msgid "" "otherwise, an error will be raised." msgstr "" -#: ../../library/functions.rst:1256 +#: ../../library/functions.rst:1253 msgid "" "A custom opener can be used by passing a callable as *opener*. The " "underlying file descriptor for the file object is then obtained by calling " @@ -2242,12 +2236,12 @@ msgid "" "similar to passing ``None``)." msgstr "" -#: ../../library/functions.rst:1262 +#: ../../library/functions.rst:1259 #, fuzzy msgid "The newly created file is :ref:`non-inheritable `." msgstr "新建立的檔案是 :ref:`不可繼承的 `。" -#: ../../library/functions.rst:1264 +#: ../../library/functions.rst:1261 #, fuzzy msgid "" "The following example uses the :ref:`dir_fd ` parameter of the :func:" @@ -2256,7 +2250,7 @@ msgstr "" "下面的示例使用 :func:`os.open` 函式返回值傳給 :ref:`dir_fd ` 的形參，" "從給定的目錄中用相對路徑開啟檔案::" -#: ../../library/functions.rst:1277 +#: ../../library/functions.rst:1274 msgid "" "The type of :term:`file object` returned by the :func:`open` function " "depends on the mode. When :func:`open` is used to open a file in a text " @@ -2271,7 +2265,7 @@ msgid "" "FileIO`, is returned." msgstr "" -#: ../../library/functions.rst:1298 +#: ../../library/functions.rst:1295 #, fuzzy msgid "" "See also the file handling modules, such as :mod:`fileinput`, :mod:`io` " @@ -2281,34 +2275,34 @@ msgstr "" "另請參閱檔案操作模組，例如 :mod:`fileinput`、:mod:`io` （聲明瞭 :func:" "`open`）、:mod:`os`、:mod:`os.path`、:mod:`tempfile` 和 :mod:`shutil`。" -#: ../../library/functions.rst:1302 +#: ../../library/functions.rst:1299 msgid "" "Raises an :ref:`auditing event ` ``open`` with arguments ``file``, " "``mode``, ``flags``." msgstr "" -#: ../../library/functions.rst:1304 +#: ../../library/functions.rst:1301 msgid "" "The ``mode`` and ``flags`` arguments may have been modified or inferred from " "the original call." msgstr "" -#: ../../library/functions.rst:1310 +#: ../../library/functions.rst:1307 #, fuzzy msgid "The *opener* parameter was added." msgstr "增加了 *opener* 形參。" -#: ../../library/functions.rst:1311 +#: ../../library/functions.rst:1308 #, fuzzy msgid "The ``'x'`` mode was added." msgstr "增加了 ``'x'`` 模式。" -#: ../../library/functions.rst:1312 +#: ../../library/functions.rst:1309 #, fuzzy msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." msgstr "過去觸發的 :exc:`IOError`，現在是 :exc:`OSError` 的別名。" -#: ../../library/functions.rst:1313 +#: ../../library/functions.rst:1310 #, fuzzy msgid "" ":exc:`FileExistsError` is now raised if the file opened in exclusive " @@ -2317,17 +2311,17 @@ msgstr "" "如果檔案已存在但使用了排它性建立模式（ ``'x'`` ），現在會觸發 :exc:" "`FileExistsError`。" -#: ../../library/functions.rst:1319 +#: ../../library/functions.rst:1316 #, fuzzy msgid "The file is now non-inheritable." msgstr "檔案現在禁止繼承。" -#: ../../library/functions.rst:1323 +#: ../../library/functions.rst:1320 #, fuzzy msgid "The ``'U'`` mode." msgstr "``'U'`` 模式。" -#: ../../library/functions.rst:1328 +#: ../../library/functions.rst:1325 #, fuzzy msgid "" "If the system call is interrupted and the signal handler does not raise an " @@ -2337,17 +2331,17 @@ msgstr "" "如果系統呼叫被中斷，但訊號處理程式沒有觸發異常，此函式現在會重試系統呼叫，而" "不是觸發 :exc:`InterruptedError` 異常（原因詳見 :pep:`475`）。" -#: ../../library/functions.rst:1331 +#: ../../library/functions.rst:1328 #, fuzzy msgid "The ``'namereplace'`` error handler was added." msgstr "增加了 ``'namereplace'`` 錯誤處理介面。" -#: ../../library/functions.rst:1336 +#: ../../library/functions.rst:1333 #, fuzzy msgid "Support added to accept objects implementing :class:`os.PathLike`." msgstr "增加對實現了 :class:`os.PathLike` 物件的支援。" -#: ../../library/functions.rst:1337 +#: ../../library/functions.rst:1334 #, fuzzy msgid "" "On Windows, opening a console buffer may return a subclass of :class:`io." @@ -2356,7 +2350,7 @@ msgstr "" "在 Windows 上，開啟一個控制檯緩衝區將返回 :class:`io.RawIOBase` 的子類，而不" "是 :class:`io.FileIO`。" -#: ../../library/functions.rst:1342 +#: ../../library/functions.rst:1339 #, fuzzy msgid "" "Given a string representing one Unicode character, return an integer " @@ -2368,7 +2362,7 @@ msgstr "" "``ord('a')`` 返回整數 ``97``， ``ord('€')`` （歐元符合）返回 ``8364`` 。這" "是 :func:`chr` 的逆函式。" -#: ../../library/functions.rst:1350 +#: ../../library/functions.rst:1347 #, fuzzy msgid "" "Return *base* to the power *exp*; if *mod* is present, return *base* to the " @@ -2379,7 +2373,7 @@ msgstr "" "返回 *x* 的 *y* 次冪；如果 *z* 存在，則對 *z* 取餘（比直接 ``pow(x, y) % z`` " "計算更高效）。兩個引數形式的 ``pow(x, y)`` 等價於冪運算子： ``x**y``。" -#: ../../library/functions.rst:1355 +#: ../../library/functions.rst:1352 msgid "" "The arguments must have numeric types. With mixed operand types, the " "coercion rules for binary arithmetic operators apply. For :class:`int` " @@ -2392,7 +2386,7 @@ msgid "" "close to ``3j``." msgstr "" -#: ../../library/functions.rst:1365 +#: ../../library/functions.rst:1362 msgid "" "For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must " "also be of integer type and *mod* must be nonzero. If *mod* is present and " @@ -2401,29 +2395,29 @@ msgid "" "*base* modulo *mod*." msgstr "" -#: ../../library/functions.rst:1371 +#: ../../library/functions.rst:1368 msgid "Here's an example of computing an inverse for ``38`` modulo ``97``::" msgstr "" -#: ../../library/functions.rst:1378 +#: ../../library/functions.rst:1375 msgid "" "For :class:`int` operands, the three-argument form of ``pow`` now allows the " "second argument to be negative, permitting computation of modular inverses." msgstr "" -#: ../../library/functions.rst:1383 +#: ../../library/functions.rst:1380 msgid "" "Allow keyword arguments. Formerly, only positional arguments were supported." msgstr "" -#: ../../library/functions.rst:1390 +#: ../../library/functions.rst:1387 msgid "" "Print *objects* to the text stream *file*, separated by *sep* and followed " "by *end*. *sep*, *end*, *file*, and *flush*, if present, must be given as " "keyword arguments." msgstr "" -#: ../../library/functions.rst:1394 +#: ../../library/functions.rst:1391 msgid "" "All non-keyword arguments are converted to strings like :func:`str` does and " "written to the stream, separated by *sep* and followed by *end*. Both *sep* " @@ -2432,7 +2426,7 @@ msgid "" "*end*." msgstr "" -#: ../../library/functions.rst:1400 +#: ../../library/functions.rst:1397 msgid "" "The *file* argument must be an object with a ``write(string)`` method; if it " "is not present or ``None``, :data:`sys.stdout` will be used. Since printed " @@ -2440,40 +2434,40 @@ msgid "" "binary mode file objects. For these, use ``file.write(...)`` instead." msgstr "" -#: ../../library/functions.rst:1405 +#: ../../library/functions.rst:1402 msgid "" "Whether the output is buffered is usually determined by *file*, but if the " "*flush* keyword argument is true, the stream is forcibly flushed." msgstr "" -#: ../../library/functions.rst:1408 +#: ../../library/functions.rst:1405 #, fuzzy msgid "Added the *flush* keyword argument." msgstr "增加了 *flush* keyword 實參。" -#: ../../library/functions.rst:1414 +#: ../../library/functions.rst:1411 #, fuzzy msgid "Return a property attribute." msgstr "返回 property 屬性。" -#: ../../library/functions.rst:1416 +#: ../../library/functions.rst:1413 msgid "" "*fget* is a function for getting an attribute value. *fset* is a function " "for setting an attribute value. *fdel* is a function for deleting an " "attribute value. And *doc* creates a docstring for the attribute." msgstr "" -#: ../../library/functions.rst:1420 +#: ../../library/functions.rst:1417 msgid "A typical use is to define a managed attribute ``x``::" msgstr "" -#: ../../library/functions.rst:1437 +#: ../../library/functions.rst:1434 msgid "" "If *c* is an instance of *C*, ``c.x`` will invoke the getter, ``c.x = " "value`` will invoke the setter, and ``del c.x`` the deleter." msgstr "" -#: ../../library/functions.rst:1440 +#: ../../library/functions.rst:1437 msgid "" "If given, *doc* will be the docstring of the property attribute. Otherwise, " "the property will copy *fget*'s docstring (if it exists). This makes it " @@ -2481,14 +2475,14 @@ msgid "" "term:`decorator`::" msgstr "" -#: ../../library/functions.rst:1453 +#: ../../library/functions.rst:1450 msgid "" "The ``@property`` decorator turns the :meth:`voltage` method into a \"getter" "\" for a read-only attribute with the same name, and it sets the docstring " "for *voltage* to \"Get the current voltage.\"" msgstr "" -#: ../../library/functions.rst:1457 +#: ../../library/functions.rst:1454 msgid "" "A property object has :attr:`~property.getter`, :attr:`~property.setter`, " "and :attr:`~property.deleter` methods usable as decorators that create a " @@ -2496,30 +2490,30 @@ msgid "" "decorated function. This is best explained with an example::" msgstr "" -#: ../../library/functions.rst:1479 +#: ../../library/functions.rst:1476 msgid "" "This code is exactly equivalent to the first example. Be sure to give the " "additional functions the same name as the original property (``x`` in this " "case.)" msgstr "" -#: ../../library/functions.rst:1483 +#: ../../library/functions.rst:1480 msgid "" "The returned property object also has the attributes ``fget``, ``fset``, and " "``fdel`` corresponding to the constructor arguments." msgstr "" -#: ../../library/functions.rst:1486 +#: ../../library/functions.rst:1483 msgid "The docstrings of property objects are now writeable." msgstr "" -#: ../../library/functions.rst:1495 +#: ../../library/functions.rst:1492 msgid "" "Rather than being a function, :class:`range` is actually an immutable " "sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`." msgstr "" -#: ../../library/functions.rst:1501 +#: ../../library/functions.rst:1498 msgid "" "Return a string containing a printable representation of an object. For " "many types, this function makes an attempt to return a string that would " @@ -2530,7 +2524,7 @@ msgid "" "function returns for its instances by defining a :meth:`__repr__` method." msgstr "" -#: ../../library/functions.rst:1512 +#: ../../library/functions.rst:1509 msgid "" "Return a reverse :term:`iterator`. *seq* must be an object which has a :" "meth:`__reversed__` method or supports the sequence protocol (the :meth:" @@ -2538,14 +2532,14 @@ msgid "" "starting at ``0``)." msgstr "" -#: ../../library/functions.rst:1520 +#: ../../library/functions.rst:1517 msgid "" "Return *number* rounded to *ndigits* precision after the decimal point. If " "*ndigits* is omitted or is ``None``, it returns the nearest integer to its " "input." msgstr "" -#: ../../library/functions.rst:1524 +#: ../../library/functions.rst:1521 msgid "" "For the built-in types supporting :func:`round`, values are rounded to the " "closest multiple of 10 to the power minus *ndigits*; if two multiples are " @@ -2556,13 +2550,13 @@ msgid "" "``None``. Otherwise, the return value has the same type as *number*." msgstr "" -#: ../../library/functions.rst:1533 +#: ../../library/functions.rst:1530 msgid "" "For a general Python object ``number``, ``round`` delegates to ``number." "__round__``." msgstr "" -#: ../../library/functions.rst:1538 +#: ../../library/functions.rst:1535 msgid "" "The behavior of :func:`round` for floats can be surprising: for example, " "``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is " @@ -2571,21 +2565,21 @@ msgid "" "information." msgstr "" -#: ../../library/functions.rst:1549 +#: ../../library/functions.rst:1546 msgid "" "Return a new :class:`set` object, optionally with elements taken from " "*iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-" "set` for documentation about this class." msgstr "" -#: ../../library/functions.rst:1553 +#: ../../library/functions.rst:1550 msgid "" "For other containers see the built-in :class:`frozenset`, :class:`list`, :" "class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` " "module." msgstr "" -#: ../../library/functions.rst:1560 +#: ../../library/functions.rst:1557 #, fuzzy msgid "" "This is the counterpart of :func:`getattr`. The arguments are an object, a " @@ -2598,14 +2592,14 @@ msgstr "" "屬性。如果物件允許，該函式將刪除指定的屬性。例如 ``delattr(x, 'foobar')`` 等" "價於 ``del x.foobar`` 。" -#: ../../library/functions.rst:1568 +#: ../../library/functions.rst:1565 msgid "" "Since :ref:`private name mangling ` happens at " "compilation time, one must manually mangle a private attribute's (attributes " "with two leading underscores) name in order to set it with :func:`setattr`." msgstr "" -#: ../../library/functions.rst:1577 +#: ../../library/functions.rst:1574 msgid "" "Return a :term:`slice` object representing the set of indices specified by " "``range(start, stop, step)``. The *start* and *step* arguments default to " @@ -2618,35 +2612,35 @@ msgid "" "func:`itertools.islice` for an alternate version that returns an iterator." msgstr "" -#: ../../library/functions.rst:1590 +#: ../../library/functions.rst:1587 msgid "Return a new sorted list from the items in *iterable*." msgstr "" -#: ../../library/functions.rst:1592 +#: ../../library/functions.rst:1589 msgid "" "Has two optional arguments which must be specified as keyword arguments." msgstr "有兩個選擇性參數，只能使用關鍵字參數指定。" -#: ../../library/functions.rst:1594 +#: ../../library/functions.rst:1591 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each element in *iterable* (for example, ``key=str." "lower``). The default value is ``None`` (compare the elements directly)." msgstr "" -#: ../../library/functions.rst:1598 +#: ../../library/functions.rst:1595 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." msgstr "" -#: ../../library/functions.rst:1601 +#: ../../library/functions.rst:1598 msgid "" "Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a " "*key* function." msgstr "" -#: ../../library/functions.rst:1604 +#: ../../library/functions.rst:1601 msgid "" "The built-in :func:`sorted` function is guaranteed to be stable. A sort is " "stable if it guarantees not to change the relative order of elements that " @@ -2654,7 +2648,7 @@ msgid "" "example, sort by department, then by salary grade)." msgstr "" -#: ../../library/functions.rst:1609 +#: ../../library/functions.rst:1606 msgid "" "The sort algorithm uses only ``<`` comparisons between items. While " "defining an :meth:`~object.__lt__` method will suffice for sorting, :PEP:`8` " @@ -2666,22 +2660,22 @@ msgid "" "method." msgstr "" -#: ../../library/functions.rst:1618 +#: ../../library/functions.rst:1615 msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -#: ../../library/functions.rst:1622 +#: ../../library/functions.rst:1619 msgid "Transform a method into a static method." msgstr "" -#: ../../library/functions.rst:1624 +#: ../../library/functions.rst:1621 msgid "" "A static method does not receive an implicit first argument. To declare a " "static method, use this idiom::" msgstr "" -#: ../../library/functions.rst:1631 +#: ../../library/functions.rst:1628 #, fuzzy msgid "" "The ``@staticmethod`` form is a function :term:`decorator` -- see :ref:" @@ -2690,7 +2684,7 @@ msgstr "" "``@classmethod`` 形式是一個函式 :term:`decorator` - 參見 :ref:`function` 中關" "於函式定義的詳細介紹。" -#: ../../library/functions.rst:1634 +#: ../../library/functions.rst:1631 #, fuzzy msgid "" "A static method can be called either on the class (such as ``C.f()``) or on " @@ -2700,14 +2694,14 @@ msgstr "" "它可以同時在類（如 ``C.f()``）和例項（如 ``C().f()``）上呼叫。例項除了它的類" "資訊，其他都會被忽略。如果一個類方法在子類上呼叫，子類會作為第一個實參傳入。" -#: ../../library/functions.rst:1638 +#: ../../library/functions.rst:1635 msgid "" "Static methods in Python are similar to those found in Java or C++. Also, " "see :func:`classmethod` for a variant that is useful for creating alternate " "class constructors." msgstr "" -#: ../../library/functions.rst:1642 +#: ../../library/functions.rst:1639 msgid "" "Like all decorators, it is also possible to call ``staticmethod`` as a " "regular function and do something with its result. This is needed in some " @@ -2716,37 +2710,37 @@ msgid "" "cases, use this idiom::" msgstr "" -#: ../../library/functions.rst:1654 +#: ../../library/functions.rst:1651 #, fuzzy msgid "For more information on static methods, see :ref:`types`." msgstr "關於類方法的更多資訊，請參考文件 :ref:`types` 中的標準型別的層次。" -#: ../../library/functions.rst:1656 +#: ../../library/functions.rst:1653 msgid "" "Static methods now inherit the method attributes (``__module__``, " "``__name__``, ``__qualname__``, ``__doc__`` and ``__annotations__``), have a " "new ``__wrapped__`` attribute, and are now callable as regular functions." msgstr "" -#: ../../library/functions.rst:1671 +#: ../../library/functions.rst:1668 msgid "" "Return a :class:`str` version of *object*. See :func:`str` for details." msgstr "" -#: ../../library/functions.rst:1673 +#: ../../library/functions.rst:1670 msgid "" "``str`` is the built-in string :term:`class`. For general information about " "strings, see :ref:`textseq`." msgstr "" -#: ../../library/functions.rst:1679 +#: ../../library/functions.rst:1676 msgid "" "Sums *start* and the items of an *iterable* from left to right and returns " "the total. The *iterable*'s items are normally numbers, and the start value " "is not allowed to be a string." msgstr "" -#: ../../library/functions.rst:1683 +#: ../../library/functions.rst:1680 msgid "" "For some use cases, there are good alternatives to :func:`sum`. The " "preferred, fast way to concatenate a sequence of strings is by calling ``''." @@ -2755,32 +2749,32 @@ msgid "" "using :func:`itertools.chain`." msgstr "" -#: ../../library/functions.rst:1689 +#: ../../library/functions.rst:1686 #, fuzzy msgid "The *start* parameter can be specified as a keyword argument." msgstr "有兩個選擇性參數，只能使用關鍵字參數指定。" -#: ../../library/functions.rst:1694 +#: ../../library/functions.rst:1691 msgid "" "Return a proxy object that delegates method calls to a parent or sibling " "class of *type*. This is useful for accessing inherited methods that have " "been overridden in a class." msgstr "" -#: ../../library/functions.rst:1698 +#: ../../library/functions.rst:1695 msgid "" "The *object-or-type* determines the :term:`method resolution order` to be " "searched. The search starts from the class right after the *type*." msgstr "" -#: ../../library/functions.rst:1702 +#: ../../library/functions.rst:1699 msgid "" "For example, if :attr:`~class.__mro__` of *object-or-type* is ``D -> B -> C -" "> A -> object`` and the value of *type* is ``B``, then :func:`super` " "searches ``C -> A -> object``." msgstr "" -#: ../../library/functions.rst:1706 +#: ../../library/functions.rst:1703 msgid "" "The :attr:`~class.__mro__` attribute of the *object-or-type* lists the " "method resolution search order used by both :func:`getattr` and :func:" @@ -2788,7 +2782,7 @@ msgid "" "hierarchy is updated." msgstr "" -#: ../../library/functions.rst:1711 +#: ../../library/functions.rst:1708 msgid "" "If the second argument is omitted, the super object returned is unbound. If " "the second argument is an object, ``isinstance(obj, type)`` must be true. " @@ -2796,7 +2790,7 @@ msgid "" "(this is useful for classmethods)." msgstr "" -#: ../../library/functions.rst:1716 +#: ../../library/functions.rst:1713 msgid "" "There are two typical use cases for *super*. In a class hierarchy with " "single inheritance, *super* can be used to refer to parent classes without " @@ -2804,7 +2798,7 @@ msgid "" "closely parallels the use of *super* in other programming languages." msgstr "" -#: ../../library/functions.rst:1721 +#: ../../library/functions.rst:1718 msgid "" "The second use case is to support cooperative multiple inheritance in a " "dynamic execution environment. This use case is unique to Python and is not " @@ -2817,18 +2811,18 @@ msgid "" "classes that are unknown prior to runtime)." msgstr "" -#: ../../library/functions.rst:1731 +#: ../../library/functions.rst:1728 msgid "For both use cases, a typical superclass call looks like this::" msgstr "" -#: ../../library/functions.rst:1738 +#: ../../library/functions.rst:1735 msgid "" "In addition to method lookups, :func:`super` also works for attribute " "lookups. One possible use case for this is calling :term:`descriptors " "` in a parent or sibling class." msgstr "" -#: ../../library/functions.rst:1742 +#: ../../library/functions.rst:1739 msgid "" "Note that :func:`super` is implemented as part of the binding process for " "explicit dotted attribute lookups such as ``super().__getitem__(name)``. It " @@ -2838,7 +2832,7 @@ msgid "" "using statements or operators such as ``super()[name]``." msgstr "" -#: ../../library/functions.rst:1749 +#: ../../library/functions.rst:1746 msgid "" "Also note that, aside from the zero argument form, :func:`super` is not " "limited to use inside methods. The two argument form specifies the " @@ -2848,33 +2842,33 @@ msgid "" "accessing the current instance for ordinary methods." msgstr "" -#: ../../library/functions.rst:1756 +#: ../../library/functions.rst:1753 msgid "" "For practical suggestions on how to design cooperative classes using :func:" "`super`, see `guide to using super() `_." msgstr "" -#: ../../library/functions.rst:1765 +#: ../../library/functions.rst:1762 msgid "" "Rather than being a function, :class:`tuple` is actually an immutable " "sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`." msgstr "" -#: ../../library/functions.rst:1774 +#: ../../library/functions.rst:1771 msgid "" "With one argument, return the type of an *object*. The return value is a " "type object and generally the same object as returned by :attr:`object." "__class__ `." msgstr "" -#: ../../library/functions.rst:1778 +#: ../../library/functions.rst:1775 msgid "" "The :func:`isinstance` built-in function is recommended for testing the type " "of an object, because it takes subclasses into account." msgstr "" -#: ../../library/functions.rst:1782 +#: ../../library/functions.rst:1779 msgid "" "With three arguments, return a new type object. This is essentially a " "dynamic form of the :keyword:`class` statement. The *name* string is the " @@ -2887,11 +2881,11 @@ msgid "" "identical :class:`type` objects:" msgstr "" -#: ../../library/functions.rst:1797 +#: ../../library/functions.rst:1794 msgid "See also :ref:`bltin-type-objects`." msgstr "" -#: ../../library/functions.rst:1799 +#: ../../library/functions.rst:1796 msgid "" "Keyword arguments provided to the three argument form are passed to the " "appropriate metaclass machinery (usually :meth:`~object.__init_subclass__`) " @@ -2899,23 +2893,23 @@ msgid "" "would." msgstr "" -#: ../../library/functions.rst:1804 +#: ../../library/functions.rst:1801 msgid "See also :ref:`class-customization`." msgstr "另請參閱 :ref:`class-customization`。" -#: ../../library/functions.rst:1806 +#: ../../library/functions.rst:1803 msgid "" "Subclasses of :class:`type` which don't override ``type.__new__`` may no " "longer use the one-argument form to get the type of an object." msgstr "" -#: ../../library/functions.rst:1812 +#: ../../library/functions.rst:1809 msgid "" "Return the :attr:`~object.__dict__` attribute for a module, class, instance, " "or any other object with a :attr:`~object.__dict__` attribute." msgstr "" -#: ../../library/functions.rst:1815 +#: ../../library/functions.rst:1812 msgid "" "Objects such as modules and instances have an updateable :attr:`~object." "__dict__` attribute; however, other objects may have write restrictions on " @@ -2923,54 +2917,54 @@ msgid "" "`types.MappingProxyType` to prevent direct dictionary updates)." msgstr "" -#: ../../library/functions.rst:1820 +#: ../../library/functions.rst:1817 msgid "" "Without an argument, :func:`vars` acts like :func:`locals`. Note, the " "locals dictionary is only useful for reads since updates to the locals " "dictionary are ignored." msgstr "" -#: ../../library/functions.rst:1824 +#: ../../library/functions.rst:1821 msgid "" "A :exc:`TypeError` exception is raised if an object is specified but it " "doesn't have a :attr:`~object.__dict__` attribute (for example, if its class " "defines the :attr:`~object.__slots__` attribute)." msgstr "" -#: ../../library/functions.rst:1830 +#: ../../library/functions.rst:1827 msgid "" "Iterate over several iterables in parallel, producing tuples with an item " "from each one." msgstr "" -#: ../../library/functions.rst:1833 +#: ../../library/functions.rst:1830 msgid "Example::" msgstr "" "例如：\n" "\n" "::" -#: ../../library/functions.rst:1842 +#: ../../library/functions.rst:1839 msgid "" "More formally: :func:`zip` returns an iterator of tuples, where the *i*-th " "tuple contains the *i*-th element from each of the argument iterables." msgstr "" -#: ../../library/functions.rst:1845 +#: ../../library/functions.rst:1842 msgid "" "Another way to think of :func:`zip` is that it turns rows into columns, and " "columns into rows. This is similar to `transposing a matrix `_." msgstr "" -#: ../../library/functions.rst:1849 +#: ../../library/functions.rst:1846 msgid "" ":func:`zip` is lazy: The elements won't be processed until the iterable is " "iterated on, e.g. by a :keyword:`!for` loop or by wrapping in a :class:" "`list`." msgstr "" -#: ../../library/functions.rst:1853 +#: ../../library/functions.rst:1850 msgid "" "One thing to consider is that the iterables passed to :func:`zip` could have " "different lengths; sometimes by design, and sometimes because of a bug in " @@ -2978,51 +2972,51 @@ msgid "" "approaches to dealing with this issue:" msgstr "" -#: ../../library/functions.rst:1858 +#: ../../library/functions.rst:1855 msgid "" "By default, :func:`zip` stops when the shortest iterable is exhausted. It " "will ignore the remaining items in the longer iterables, cutting off the " "result to the length of the shortest iterable::" msgstr "" -#: ../../library/functions.rst:1865 +#: ../../library/functions.rst:1862 msgid "" ":func:`zip` is often used in cases where the iterables are assumed to be of " "equal length. In such cases, it's recommended to use the ``strict=True`` " "option. Its output is the same as regular :func:`zip`::" msgstr "" -#: ../../library/functions.rst:1872 +#: ../../library/functions.rst:1869 msgid "" "Unlike the default behavior, it checks that the lengths of iterables are " "identical, raising a :exc:`ValueError` if they aren't:" msgstr "" -#: ../../library/functions.rst:1880 +#: ../../library/functions.rst:1877 msgid "" "Without the ``strict=True`` argument, any bug that results in iterables of " "different lengths will be silenced, possibly manifesting as a hard-to-find " "bug in another part of the program." msgstr "" -#: ../../library/functions.rst:1884 +#: ../../library/functions.rst:1881 msgid "" "Shorter iterables can be padded with a constant value to make all the " "iterables have the same length. This is done by :func:`itertools." "zip_longest`." msgstr "" -#: ../../library/functions.rst:1888 +#: ../../library/functions.rst:1885 msgid "" "Edge cases: With a single iterable argument, :func:`zip` returns an iterator " "of 1-tuples. With no arguments, it returns an empty iterator." msgstr "" -#: ../../library/functions.rst:1891 +#: ../../library/functions.rst:1888 msgid "Tips and tricks:" msgstr "" -#: ../../library/functions.rst:1893 +#: ../../library/functions.rst:1890 msgid "" "The left-to-right evaluation order of the iterables is guaranteed. This " "makes possible an idiom for clustering a data series into n-length groups " @@ -3031,23 +3025,23 @@ msgid "" "iterator. This has the effect of dividing the input into n-length chunks." msgstr "" -#: ../../library/functions.rst:1899 +#: ../../library/functions.rst:1896 msgid "" ":func:`zip` in conjunction with the ``*`` operator can be used to unzip a " "list::" msgstr "" -#: ../../library/functions.rst:1910 +#: ../../library/functions.rst:1907 msgid "Added the ``strict`` argument." msgstr "增加了 ``strict`` 參數。" -#: ../../library/functions.rst:1922 +#: ../../library/functions.rst:1919 msgid "" "This is an advanced function that is not needed in everyday Python " "programming, unlike :func:`importlib.import_module`." msgstr "" -#: ../../library/functions.rst:1925 +#: ../../library/functions.rst:1922 msgid "" "This function is invoked by the :keyword:`import` statement. It can be " "replaced (by importing the :mod:`builtins` module and assigning to " @@ -3059,7 +3053,7 @@ msgid "" "discouraged in favor of :func:`importlib.import_module`." msgstr "" -#: ../../library/functions.rst:1934 +#: ../../library/functions.rst:1931 msgid "" "The function imports the module *name*, potentially using the given " "*globals* and *locals* to determine how to interpret the name in a package " @@ -3069,7 +3063,7 @@ msgid "" "determine the package context of the :keyword:`import` statement." msgstr "" -#: ../../library/functions.rst:1941 +#: ../../library/functions.rst:1938 msgid "" "*level* specifies whether to use absolute or relative imports. ``0`` (the " "default) means only perform absolute imports. Positive values for *level* " @@ -3078,7 +3072,7 @@ msgid "" "details)." msgstr "" -#: ../../library/functions.rst:1947 +#: ../../library/functions.rst:1944 msgid "" "When the *name* variable is of the form ``package.module``, normally, the " "top-level package (the name up till the first dot) is returned, *not* the " @@ -3086,58 +3080,58 @@ msgid "" "given, the module named by *name* is returned." msgstr "" -#: ../../library/functions.rst:1952 +#: ../../library/functions.rst:1949 msgid "" "For example, the statement ``import spam`` results in bytecode resembling " "the following code::" msgstr "" -#: ../../library/functions.rst:1957 +#: ../../library/functions.rst:1954 msgid "The statement ``import spam.ham`` results in this call::" msgstr "" -#: ../../library/functions.rst:1961 +#: ../../library/functions.rst:1958 msgid "" "Note how :func:`__import__` returns the toplevel module here because this is " "the object that is bound to a name by the :keyword:`import` statement." msgstr "" -#: ../../library/functions.rst:1964 +#: ../../library/functions.rst:1961 msgid "" "On the other hand, the statement ``from spam.ham import eggs, sausage as " "saus`` results in ::" msgstr "" -#: ../../library/functions.rst:1971 +#: ../../library/functions.rst:1968 msgid "" "Here, the ``spam.ham`` module is returned from :func:`__import__`. From " "this object, the names to import are retrieved and assigned to their " "respective names." msgstr "" -#: ../../library/functions.rst:1975 +#: ../../library/functions.rst:1972 msgid "" "If you simply want to import a module (potentially within a package) by " "name, use :func:`importlib.import_module`." msgstr "" -#: ../../library/functions.rst:1978 +#: ../../library/functions.rst:1975 msgid "" "Negative values for *level* are no longer supported (which also changes the " "default value to 0)." msgstr "" -#: ../../library/functions.rst:1982 +#: ../../library/functions.rst:1979 msgid "" "When the command line options :option:`-E` or :option:`-I` are being used, " "the environment variable :envvar:`PYTHONCASEOK` is now ignored." msgstr "" -#: ../../library/functions.rst:1987 +#: ../../library/functions.rst:1984 msgid "Footnotes" msgstr "註解" -#: ../../library/functions.rst:1988 +#: ../../library/functions.rst:1985 #, fuzzy msgid "" "Note that the parser only accepts the Unix-style end of line convention. If " diff --git a/library/os.path.po b/library/os.path.po index 9f21a280b0..5a17c5aeb0 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -27,6 +27,8 @@ msgid "" "**Source code:** :source:`Lib/posixpath.py` (for POSIX) and :source:`Lib/" "ntpath.py` (for Windows NT)." msgstr "" +"**原始碼：**\\ :source:`Lib/posixpath.py`\\ （對於 POSIX）與 :source:`Lib/" +"ntpath.py`\\（對於 Windows NT）。" #: ../../library/os.path.rst:14 msgid "" diff --git a/library/profile.po b/library/profile.po index 7c3eea2b02..24a0699be4 100644 --- a/library/profile.po +++ b/library/profile.po @@ -24,7 +24,7 @@ msgstr "" #: ../../library/profile.rst:7 msgid "**Source code:** :source:`Lib/profile.py` and :source:`Lib/pstats.py`" -msgstr "**原始碼：**\\ :source:`Lib/profile.py` and :source:`Lib/pstats.py`" +msgstr "**原始碼：**\\ :source:`Lib/profile.py` 與 :source:`Lib/pstats.py`" #: ../../library/profile.rst:14 msgid "Introduction to the profilers" diff --git a/library/stdtypes.po b/library/stdtypes.po index 9ab3865124..45a885580f 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -8,7 +8,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: 2021-11-23 00:09+0000\n" "PO-Revision-Date: 2018-05-23 16:11+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -103,21 +103,21 @@ msgstr "" #: ../../library/stdtypes.rst:85 ../../library/stdtypes.rst:143 #: ../../library/stdtypes.rst:274 ../../library/stdtypes.rst:363 -#: ../../library/stdtypes.rst:413 ../../library/stdtypes.rst:881 -#: ../../library/stdtypes.rst:1076 +#: ../../library/stdtypes.rst:413 ../../library/stdtypes.rst:882 +#: ../../library/stdtypes.rst:1077 msgid "Operation" msgstr "" #: ../../library/stdtypes.rst:85 ../../library/stdtypes.rst:274 #: ../../library/stdtypes.rst:363 ../../library/stdtypes.rst:413 -#: ../../library/stdtypes.rst:881 ../../library/stdtypes.rst:1076 +#: ../../library/stdtypes.rst:882 ../../library/stdtypes.rst:1077 msgid "Result" msgstr "結果" #: ../../library/stdtypes.rst:85 ../../library/stdtypes.rst:274 -#: ../../library/stdtypes.rst:413 ../../library/stdtypes.rst:881 -#: ../../library/stdtypes.rst:1076 ../../library/stdtypes.rst:2308 -#: ../../library/stdtypes.rst:3529 +#: ../../library/stdtypes.rst:413 ../../library/stdtypes.rst:882 +#: ../../library/stdtypes.rst:1077 ../../library/stdtypes.rst:2309 +#: ../../library/stdtypes.rst:3530 msgid "Notes" msgstr "註解" @@ -130,9 +130,9 @@ msgid "if *x* is false, then *y*, else *x*" msgstr "" #: ../../library/stdtypes.rst:87 ../../library/stdtypes.rst:284 -#: ../../library/stdtypes.rst:883 ../../library/stdtypes.rst:886 -#: ../../library/stdtypes.rst:1087 ../../library/stdtypes.rst:2314 -#: ../../library/stdtypes.rst:3535 +#: ../../library/stdtypes.rst:884 ../../library/stdtypes.rst:887 +#: ../../library/stdtypes.rst:1088 ../../library/stdtypes.rst:2315 +#: ../../library/stdtypes.rst:3536 msgid "\\(1)" msgstr "\\(1)" @@ -145,9 +145,9 @@ msgid "if *x* is false, then *x*, else *y*" msgstr "" #: ../../library/stdtypes.rst:90 ../../library/stdtypes.rst:287 -#: ../../library/stdtypes.rst:307 ../../library/stdtypes.rst:1115 -#: ../../library/stdtypes.rst:2318 ../../library/stdtypes.rst:2320 -#: ../../library/stdtypes.rst:3539 ../../library/stdtypes.rst:3541 +#: ../../library/stdtypes.rst:307 ../../library/stdtypes.rst:1116 +#: ../../library/stdtypes.rst:2319 ../../library/stdtypes.rst:2321 +#: ../../library/stdtypes.rst:3540 ../../library/stdtypes.rst:3542 msgid "\\(2)" msgstr "\\(2)" @@ -159,19 +159,19 @@ msgstr "``not x``" msgid "if *x* is false, then ``True``, else ``False``" msgstr "" -#: ../../library/stdtypes.rst:93 ../../library/stdtypes.rst:895 -#: ../../library/stdtypes.rst:1118 ../../library/stdtypes.rst:2322 -#: ../../library/stdtypes.rst:2324 ../../library/stdtypes.rst:2326 -#: ../../library/stdtypes.rst:2328 ../../library/stdtypes.rst:3543 -#: ../../library/stdtypes.rst:3545 ../../library/stdtypes.rst:3547 -#: ../../library/stdtypes.rst:3549 +#: ../../library/stdtypes.rst:93 ../../library/stdtypes.rst:896 +#: ../../library/stdtypes.rst:1119 ../../library/stdtypes.rst:2323 +#: ../../library/stdtypes.rst:2325 ../../library/stdtypes.rst:2327 +#: ../../library/stdtypes.rst:2329 ../../library/stdtypes.rst:3544 +#: ../../library/stdtypes.rst:3546 ../../library/stdtypes.rst:3548 +#: ../../library/stdtypes.rst:3550 msgid "\\(3)" msgstr "\\(3)" #: ../../library/stdtypes.rst:102 ../../library/stdtypes.rst:318 -#: ../../library/stdtypes.rst:431 ../../library/stdtypes.rst:922 -#: ../../library/stdtypes.rst:1126 ../../library/stdtypes.rst:2354 -#: ../../library/stdtypes.rst:3579 +#: ../../library/stdtypes.rst:431 ../../library/stdtypes.rst:923 +#: ../../library/stdtypes.rst:1127 ../../library/stdtypes.rst:2355 +#: ../../library/stdtypes.rst:3580 msgid "Notes:" msgstr "註解：" @@ -210,9 +210,9 @@ msgstr "" msgid "This table summarizes the comparison operations:" msgstr "" -#: ../../library/stdtypes.rst:143 ../../library/stdtypes.rst:2285 -#: ../../library/stdtypes.rst:2308 ../../library/stdtypes.rst:3506 -#: ../../library/stdtypes.rst:3529 +#: ../../library/stdtypes.rst:143 ../../library/stdtypes.rst:2286 +#: ../../library/stdtypes.rst:2309 ../../library/stdtypes.rst:3507 +#: ../../library/stdtypes.rst:3530 msgid "Meaning" msgstr "" @@ -493,8 +493,8 @@ msgid "" "zero." msgstr "" -#: ../../library/stdtypes.rst:300 ../../library/stdtypes.rst:1108 -#: ../../library/stdtypes.rst:2316 ../../library/stdtypes.rst:3566 +#: ../../library/stdtypes.rst:300 ../../library/stdtypes.rst:1109 +#: ../../library/stdtypes.rst:2317 ../../library/stdtypes.rst:3567 msgid "\\(6)" msgstr "\\(6)" @@ -531,10 +531,10 @@ msgid "*x* to the power *y*" msgstr "" #: ../../library/stdtypes.rst:309 ../../library/stdtypes.rst:311 -#: ../../library/stdtypes.rst:1097 ../../library/stdtypes.rst:1100 -#: ../../library/stdtypes.rst:2341 ../../library/stdtypes.rst:2344 -#: ../../library/stdtypes.rst:2347 ../../library/stdtypes.rst:3562 -#: ../../library/stdtypes.rst:3569 +#: ../../library/stdtypes.rst:1098 ../../library/stdtypes.rst:1101 +#: ../../library/stdtypes.rst:2342 ../../library/stdtypes.rst:2345 +#: ../../library/stdtypes.rst:2348 ../../library/stdtypes.rst:3563 +#: ../../library/stdtypes.rst:3570 msgid "\\(5)" msgstr "\\(5)" @@ -669,9 +669,9 @@ msgid "bitwise :dfn:`or` of *x* and *y*" msgstr "" #: ../../library/stdtypes.rst:415 ../../library/stdtypes.rst:418 -#: ../../library/stdtypes.rst:421 ../../library/stdtypes.rst:1121 -#: ../../library/stdtypes.rst:2330 ../../library/stdtypes.rst:2334 -#: ../../library/stdtypes.rst:3551 ../../library/stdtypes.rst:3555 +#: ../../library/stdtypes.rst:421 ../../library/stdtypes.rst:1122 +#: ../../library/stdtypes.rst:2331 ../../library/stdtypes.rst:2335 +#: ../../library/stdtypes.rst:3552 ../../library/stdtypes.rst:3556 msgid "\\(4)" msgstr "\\(4)" @@ -1008,15 +1008,15 @@ msgstr "" #: ../../library/stdtypes.rst:775 msgid "" -"One method needs to be defined for container objects to provide iteration " -"support:" +"One method needs to be defined for container objects to provide :term:" +"`iterable` support:" msgstr "" #: ../../library/stdtypes.rst:782 msgid "" -"Return an iterator object. The object is required to support the iterator " -"protocol described below. If a container supports different types of " -"iteration, additional methods can be provided to specifically request " +"Return an :term:`iterator` object. The object is required to support the " +"iterator protocol described below. If a container supports different types " +"of iteration, additional methods can be provided to specifically request " "iterators for those iteration types. (An example of an object supporting " "multiple forms of iteration would be a tree structure which supports both " "breadth-first and depth-first traversal.) This method corresponds to the :c:" @@ -1032,21 +1032,21 @@ msgstr "" #: ../../library/stdtypes.rst:797 msgid "" -"Return the iterator object itself. This is required to allow both " +"Return the :term:`iterator` object itself. This is required to allow both " "containers and iterators to be used with the :keyword:`for` and :keyword:" -"`in` statements. This method corresponds to the :c:member:`~PyTypeObject." +"`in` statements. This method corresponds to the :c:member:`~PyTypeObject." "tp_iter` slot of the type structure for Python objects in the Python/C API." msgstr "" -#: ../../library/stdtypes.rst:805 +#: ../../library/stdtypes.rst:806 msgid "" -"Return the next item from the container. If there are no further items, " -"raise the :exc:`StopIteration` exception. This method corresponds to the :c:" -"member:`~PyTypeObject.tp_iternext` slot of the type structure for Python " -"objects in the Python/C API." +"Return the next item from the :term:`iterator`. If there are no further " +"items, raise the :exc:`StopIteration` exception. This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iternext` slot of the type structure for " +"Python objects in the Python/C API." msgstr "" -#: ../../library/stdtypes.rst:810 +#: ../../library/stdtypes.rst:811 msgid "" "Python defines several iterator objects to support iteration over general " "and specific sequence types, dictionaries, and other more specialized " @@ -1054,18 +1054,18 @@ msgid "" "the iterator protocol." msgstr "" -#: ../../library/stdtypes.rst:815 +#: ../../library/stdtypes.rst:816 msgid "" "Once an iterator's :meth:`~iterator.__next__` method raises :exc:" "`StopIteration`, it must continue to do so on subsequent calls. " "Implementations that do not obey this property are deemed broken." msgstr "" -#: ../../library/stdtypes.rst:823 +#: ../../library/stdtypes.rst:824 msgid "Generator Types" msgstr "" -#: ../../library/stdtypes.rst:825 +#: ../../library/stdtypes.rst:826 msgid "" "Python's :term:`generator`\\s provide a convenient way to implement the " "iterator protocol. If a container object's :meth:`__iter__` method is " @@ -1075,11 +1075,11 @@ msgid "" "found in :ref:`the documentation for the yield expression `." msgstr "" -#: ../../library/stdtypes.rst:837 +#: ../../library/stdtypes.rst:838 msgid "Sequence Types --- :class:`list`, :class:`tuple`, :class:`range`" msgstr "" -#: ../../library/stdtypes.rst:839 +#: ../../library/stdtypes.rst:840 msgid "" "There are three basic sequence types: lists, tuples, and range objects. " "Additional sequence types tailored for processing of :ref:`binary data " @@ -1087,11 +1087,11 @@ msgid "" "sections." msgstr "" -#: ../../library/stdtypes.rst:848 +#: ../../library/stdtypes.rst:849 msgid "Common Sequence Operations" msgstr "" -#: ../../library/stdtypes.rst:852 +#: ../../library/stdtypes.rst:853 msgid "" "The operations in the following table are supported by most sequence types, " "both mutable and immutable. The :class:`collections.abc.Sequence` ABC is " @@ -1099,7 +1099,7 @@ msgid "" "sequence types." msgstr "" -#: ../../library/stdtypes.rst:857 +#: ../../library/stdtypes.rst:858 msgid "" "This table lists the sequence operations sorted in ascending priority. In " "the table, *s* and *t* are sequences of the same type, *n*, *i*, *j* and *k* " @@ -1107,7 +1107,7 @@ msgid "" "restrictions imposed by *s*." msgstr "" -#: ../../library/stdtypes.rst:862 +#: ../../library/stdtypes.rst:863 msgid "" "The ``in`` and ``not in`` operations have the same priorities as the " "comparison operations. The ``+`` (concatenation) and ``*`` (repetition) " @@ -1115,125 +1115,125 @@ msgid "" "[3]_" msgstr "" -#: ../../library/stdtypes.rst:883 +#: ../../library/stdtypes.rst:884 msgid "``x in s``" msgstr "``x in s``" -#: ../../library/stdtypes.rst:883 +#: ../../library/stdtypes.rst:884 msgid "``True`` if an item of *s* is equal to *x*, else ``False``" msgstr "" -#: ../../library/stdtypes.rst:886 +#: ../../library/stdtypes.rst:887 msgid "``x not in s``" msgstr "``x not in s``" -#: ../../library/stdtypes.rst:886 +#: ../../library/stdtypes.rst:887 msgid "``False`` if an item of *s* is equal to *x*, else ``True``" msgstr "" -#: ../../library/stdtypes.rst:889 +#: ../../library/stdtypes.rst:890 msgid "``s + t``" msgstr "``s + t``" -#: ../../library/stdtypes.rst:889 +#: ../../library/stdtypes.rst:890 msgid "the concatenation of *s* and *t*" msgstr "" -#: ../../library/stdtypes.rst:889 +#: ../../library/stdtypes.rst:890 msgid "(6)(7)" msgstr "(6)(7)" -#: ../../library/stdtypes.rst:892 +#: ../../library/stdtypes.rst:893 msgid "``s * n`` or ``n * s``" msgstr "``s * n`` 或 ``n * s``" -#: ../../library/stdtypes.rst:892 +#: ../../library/stdtypes.rst:893 msgid "equivalent to adding *s* to itself *n* times" msgstr "" -#: ../../library/stdtypes.rst:892 +#: ../../library/stdtypes.rst:893 msgid "(2)(7)" msgstr "(2)(7)" -#: ../../library/stdtypes.rst:895 +#: ../../library/stdtypes.rst:896 msgid "``s[i]``" msgstr "``s[i]``" -#: ../../library/stdtypes.rst:895 +#: ../../library/stdtypes.rst:896 msgid "*i*\\ th item of *s*, origin 0" msgstr "" -#: ../../library/stdtypes.rst:897 +#: ../../library/stdtypes.rst:898 msgid "``s[i:j]``" msgstr "``s[i:j]``" -#: ../../library/stdtypes.rst:897 +#: ../../library/stdtypes.rst:898 msgid "slice of *s* from *i* to *j*" msgstr "" -#: ../../library/stdtypes.rst:897 +#: ../../library/stdtypes.rst:898 msgid "(3)(4)" msgstr "(3)(4)" -#: ../../library/stdtypes.rst:899 +#: ../../library/stdtypes.rst:900 msgid "``s[i:j:k]``" msgstr "``s[i:j:k]``" -#: ../../library/stdtypes.rst:899 +#: ../../library/stdtypes.rst:900 msgid "slice of *s* from *i* to *j* with step *k*" msgstr "" -#: ../../library/stdtypes.rst:899 +#: ../../library/stdtypes.rst:900 msgid "(3)(5)" msgstr "(3)(5)" -#: ../../library/stdtypes.rst:902 +#: ../../library/stdtypes.rst:903 msgid "``len(s)``" msgstr "``len(s)``" -#: ../../library/stdtypes.rst:902 +#: ../../library/stdtypes.rst:903 msgid "length of *s*" msgstr "" -#: ../../library/stdtypes.rst:904 +#: ../../library/stdtypes.rst:905 msgid "``min(s)``" msgstr "``min(s)``" -#: ../../library/stdtypes.rst:904 +#: ../../library/stdtypes.rst:905 msgid "smallest item of *s*" msgstr "" -#: ../../library/stdtypes.rst:906 +#: ../../library/stdtypes.rst:907 msgid "``max(s)``" msgstr "``max(s)``" -#: ../../library/stdtypes.rst:906 +#: ../../library/stdtypes.rst:907 msgid "largest item of *s*" msgstr "" -#: ../../library/stdtypes.rst:908 +#: ../../library/stdtypes.rst:909 msgid "``s.index(x[, i[, j]])``" msgstr "``s.index(x[, i[, j]])``" -#: ../../library/stdtypes.rst:908 +#: ../../library/stdtypes.rst:909 msgid "" "index of the first occurrence of *x* in *s* (at or after index *i* and " "before index *j*)" msgstr "" -#: ../../library/stdtypes.rst:908 ../../library/stdtypes.rst:3537 +#: ../../library/stdtypes.rst:909 ../../library/stdtypes.rst:3538 msgid "\\(8)" msgstr "\\(8)" -#: ../../library/stdtypes.rst:912 +#: ../../library/stdtypes.rst:913 msgid "``s.count(x)``" msgstr "``s.count(x)``" -#: ../../library/stdtypes.rst:912 +#: ../../library/stdtypes.rst:913 msgid "total number of occurrences of *x* in *s*" msgstr "" -#: ../../library/stdtypes.rst:916 +#: ../../library/stdtypes.rst:917 msgid "" "Sequences of the same type also support comparisons. In particular, tuples " "and lists are compared lexicographically by comparing corresponding " @@ -1242,7 +1242,7 @@ msgid "" "(For full details see :ref:`comparisons` in the language reference.)" msgstr "" -#: ../../library/stdtypes.rst:925 +#: ../../library/stdtypes.rst:926 msgid "" "While the ``in`` and ``not in`` operations are used only for simple " "containment testing in the general case, some specialised sequences (such " @@ -1250,7 +1250,7 @@ msgid "" "subsequence testing::" msgstr "" -#: ../../library/stdtypes.rst:934 +#: ../../library/stdtypes.rst:935 msgid "" "Values of *n* less than ``0`` are treated as ``0`` (which yields an empty " "sequence of the same type as *s*). Note that items in the sequence *s* are " @@ -1258,7 +1258,7 @@ msgid "" "Python programmers; consider::" msgstr "" -#: ../../library/stdtypes.rst:946 +#: ../../library/stdtypes.rst:947 msgid "" "What has happened is that ``[[]]`` is a one-element list containing an empty " "list, so all three elements of ``[[]] * 3`` are references to this single " @@ -1266,20 +1266,20 @@ msgid "" "list. You can create a list of different lists this way::" msgstr "" -#: ../../library/stdtypes.rst:958 +#: ../../library/stdtypes.rst:959 msgid "" "Further explanation is available in the FAQ entry :ref:`faq-multidimensional-" "list`." msgstr "" -#: ../../library/stdtypes.rst:962 +#: ../../library/stdtypes.rst:963 msgid "" "If *i* or *j* is negative, the index is relative to the end of sequence *s*: " "``len(s) + i`` or ``len(s) + j`` is substituted. But note that ``-0`` is " "still ``0``." msgstr "" -#: ../../library/stdtypes.rst:967 +#: ../../library/stdtypes.rst:968 msgid "" "The slice of *s* from *i* to *j* is defined as the sequence of items with " "index *k* such that ``i <= k < j``. If *i* or *j* is greater than " @@ -1288,7 +1288,7 @@ msgid "" "to *j*, the slice is empty." msgstr "" -#: ../../library/stdtypes.rst:974 +#: ../../library/stdtypes.rst:975 msgid "" "The slice of *s* from *i* to *j* with step *k* is defined as the sequence of " "items with index ``x = i + n*k`` such that ``0 <= n < (j-i)/k``. In other " @@ -1301,7 +1301,7 @@ msgid "" "``None``, it is treated like ``1``." msgstr "" -#: ../../library/stdtypes.rst:985 +#: ../../library/stdtypes.rst:986 msgid "" "Concatenating immutable sequences always results in a new object. This " "means that building up a sequence by repeated concatenation will have a " @@ -1309,14 +1309,14 @@ msgid "" "runtime cost, you must switch to one of the alternatives below:" msgstr "" -#: ../../library/stdtypes.rst:990 +#: ../../library/stdtypes.rst:991 msgid "" "if concatenating :class:`str` objects, you can build a list and use :meth:" "`str.join` at the end or else write to an :class:`io.StringIO` instance and " "retrieve its value when complete" msgstr "" -#: ../../library/stdtypes.rst:994 +#: ../../library/stdtypes.rst:995 msgid "" "if concatenating :class:`bytes` objects, you can similarly use :meth:`bytes." "join` or :class:`io.BytesIO`, or you can do in-place concatenation with a :" @@ -1324,22 +1324,22 @@ msgid "" "an efficient overallocation mechanism" msgstr "" -#: ../../library/stdtypes.rst:999 +#: ../../library/stdtypes.rst:1000 msgid "if concatenating :class:`tuple` objects, extend a :class:`list` instead" msgstr "" -#: ../../library/stdtypes.rst:1001 +#: ../../library/stdtypes.rst:1002 msgid "for other types, investigate the relevant class documentation" msgstr "" -#: ../../library/stdtypes.rst:1005 +#: ../../library/stdtypes.rst:1006 msgid "" "Some sequence types (such as :class:`range`) only support item sequences " "that follow specific patterns, and hence don't support sequence " "concatenation or repetition." msgstr "" -#: ../../library/stdtypes.rst:1010 +#: ../../library/stdtypes.rst:1011 msgid "" "``index`` raises :exc:`ValueError` when *x* is not found in *s*. Not all " "implementations support passing the additional arguments *i* and *j*. These " @@ -1349,42 +1349,42 @@ msgid "" "start of the sequence rather than the start of the slice." msgstr "" -#: ../../library/stdtypes.rst:1021 +#: ../../library/stdtypes.rst:1022 msgid "Immutable Sequence Types" msgstr "" -#: ../../library/stdtypes.rst:1028 +#: ../../library/stdtypes.rst:1029 msgid "" "The only operation that immutable sequence types generally implement that is " "not also implemented by mutable sequence types is support for the :func:" "`hash` built-in." msgstr "" -#: ../../library/stdtypes.rst:1032 +#: ../../library/stdtypes.rst:1033 msgid "" "This support allows immutable sequences, such as :class:`tuple` instances, " "to be used as :class:`dict` keys and stored in :class:`set` and :class:" "`frozenset` instances." msgstr "" -#: ../../library/stdtypes.rst:1036 +#: ../../library/stdtypes.rst:1037 msgid "" "Attempting to hash an immutable sequence that contains unhashable values " "will result in :exc:`TypeError`." msgstr "" -#: ../../library/stdtypes.rst:1043 +#: ../../library/stdtypes.rst:1044 msgid "Mutable Sequence Types" msgstr "" -#: ../../library/stdtypes.rst:1050 +#: ../../library/stdtypes.rst:1051 msgid "" "The operations in the following table are defined on mutable sequence types. " "The :class:`collections.abc.MutableSequence` ABC is provided to make it " "easier to correctly implement these operations on custom sequence types." msgstr "" -#: ../../library/stdtypes.rst:1054 +#: ../../library/stdtypes.rst:1055 msgid "" "In the table *s* is an instance of a mutable sequence type, *t* is any " "iterable object and *x* is an arbitrary object that meets any type and value " @@ -1392,145 +1392,145 @@ msgid "" "integers that meet the value restriction ``0 <= x <= 255``)." msgstr "" -#: ../../library/stdtypes.rst:1078 +#: ../../library/stdtypes.rst:1079 msgid "``s[i] = x``" msgstr "``s[i] = x``" -#: ../../library/stdtypes.rst:1078 +#: ../../library/stdtypes.rst:1079 msgid "item *i* of *s* is replaced by *x*" msgstr "" -#: ../../library/stdtypes.rst:1081 +#: ../../library/stdtypes.rst:1082 msgid "``s[i:j] = t``" msgstr "``s[i:j] = t``" -#: ../../library/stdtypes.rst:1081 +#: ../../library/stdtypes.rst:1082 msgid "" "slice of *s* from *i* to *j* is replaced by the contents of the iterable *t*" msgstr "" -#: ../../library/stdtypes.rst:1085 +#: ../../library/stdtypes.rst:1086 msgid "``del s[i:j]``" msgstr "``del s[i:j]``" -#: ../../library/stdtypes.rst:1085 +#: ../../library/stdtypes.rst:1086 msgid "same as ``s[i:j] = []``" msgstr "" -#: ../../library/stdtypes.rst:1087 +#: ../../library/stdtypes.rst:1088 msgid "``s[i:j:k] = t``" msgstr "``s[i:j:k] = t``" -#: ../../library/stdtypes.rst:1087 +#: ../../library/stdtypes.rst:1088 msgid "the elements of ``s[i:j:k]`` are replaced by those of *t*" msgstr "" -#: ../../library/stdtypes.rst:1090 +#: ../../library/stdtypes.rst:1091 msgid "``del s[i:j:k]``" msgstr "``del s[i:j:k]``" -#: ../../library/stdtypes.rst:1090 +#: ../../library/stdtypes.rst:1091 msgid "removes the elements of ``s[i:j:k]`` from the list" msgstr "" -#: ../../library/stdtypes.rst:1093 +#: ../../library/stdtypes.rst:1094 msgid "``s.append(x)``" msgstr "``s.append(x)``" -#: ../../library/stdtypes.rst:1093 +#: ../../library/stdtypes.rst:1094 msgid "" "appends *x* to the end of the sequence (same as ``s[len(s):len(s)] = [x]``)" msgstr "" -#: ../../library/stdtypes.rst:1097 +#: ../../library/stdtypes.rst:1098 msgid "``s.clear()``" msgstr "``s.clear()``" -#: ../../library/stdtypes.rst:1097 +#: ../../library/stdtypes.rst:1098 msgid "removes all items from *s* (same as ``del s[:]``)" msgstr "" -#: ../../library/stdtypes.rst:1100 +#: ../../library/stdtypes.rst:1101 msgid "``s.copy()``" msgstr "``s.copy()``" -#: ../../library/stdtypes.rst:1100 +#: ../../library/stdtypes.rst:1101 msgid "creates a shallow copy of *s* (same as ``s[:]``)" msgstr "" -#: ../../library/stdtypes.rst:1103 +#: ../../library/stdtypes.rst:1104 msgid "``s.extend(t)`` or ``s += t``" msgstr "``s.extend(t)`` 或 ``s += t``" -#: ../../library/stdtypes.rst:1103 +#: ../../library/stdtypes.rst:1104 msgid "" "extends *s* with the contents of *t* (for the most part the same as " "``s[len(s):len(s)] = t``)" msgstr "" -#: ../../library/stdtypes.rst:1108 +#: ../../library/stdtypes.rst:1109 msgid "``s *= n``" msgstr "``s *= n``" -#: ../../library/stdtypes.rst:1108 +#: ../../library/stdtypes.rst:1109 msgid "updates *s* with its contents repeated *n* times" msgstr "" -#: ../../library/stdtypes.rst:1111 +#: ../../library/stdtypes.rst:1112 msgid "``s.insert(i, x)``" msgstr "``s.insert(i, x)``" -#: ../../library/stdtypes.rst:1111 +#: ../../library/stdtypes.rst:1112 msgid "" "inserts *x* into *s* at the index given by *i* (same as ``s[i:i] = [x]``)" msgstr "" -#: ../../library/stdtypes.rst:1115 +#: ../../library/stdtypes.rst:1116 msgid "``s.pop()`` or ``s.pop(i)``" msgstr "``s.pop()`` 或 ``s.pop(i)``" -#: ../../library/stdtypes.rst:1115 +#: ../../library/stdtypes.rst:1116 msgid "retrieves the item at *i* and also removes it from *s*" msgstr "" -#: ../../library/stdtypes.rst:1118 +#: ../../library/stdtypes.rst:1119 msgid "``s.remove(x)``" msgstr "``s.remove(x)``" -#: ../../library/stdtypes.rst:1118 +#: ../../library/stdtypes.rst:1119 msgid "remove the first item from *s* where ``s[i]`` is equal to *x*" msgstr "" -#: ../../library/stdtypes.rst:1121 +#: ../../library/stdtypes.rst:1122 msgid "``s.reverse()``" msgstr "``s.reverse()``" -#: ../../library/stdtypes.rst:1121 +#: ../../library/stdtypes.rst:1122 msgid "reverses the items of *s* in place" msgstr "" -#: ../../library/stdtypes.rst:1129 +#: ../../library/stdtypes.rst:1130 msgid "*t* must have the same length as the slice it is replacing." msgstr "" -#: ../../library/stdtypes.rst:1132 +#: ../../library/stdtypes.rst:1133 msgid "" "The optional argument *i* defaults to ``-1``, so that by default the last " "item is removed and returned." msgstr "" -#: ../../library/stdtypes.rst:1136 +#: ../../library/stdtypes.rst:1137 msgid ":meth:`remove` raises :exc:`ValueError` when *x* is not found in *s*." msgstr "" -#: ../../library/stdtypes.rst:1139 +#: ../../library/stdtypes.rst:1140 msgid "" "The :meth:`reverse` method modifies the sequence in place for economy of " "space when reversing a large sequence. To remind users that it operates by " "side effect, it does not return the reversed sequence." msgstr "" -#: ../../library/stdtypes.rst:1144 +#: ../../library/stdtypes.rst:1145 msgid "" ":meth:`clear` and :meth:`!copy` are included for consistency with the " "interfaces of mutable containers that don't support slicing operations (such " @@ -1539,11 +1539,11 @@ msgid "" "classes provide it." msgstr "" -#: ../../library/stdtypes.rst:1150 +#: ../../library/stdtypes.rst:1151 msgid ":meth:`clear` and :meth:`!copy` methods." msgstr "" -#: ../../library/stdtypes.rst:1154 +#: ../../library/stdtypes.rst:1155 msgid "" "The value *n* is an integer, or an object implementing :meth:`~object." "__index__`. Zero and negative values of *n* clear the sequence. Items in " @@ -1551,39 +1551,39 @@ msgid "" "explained for ``s * n`` under :ref:`typesseq-common`." msgstr "" -#: ../../library/stdtypes.rst:1163 +#: ../../library/stdtypes.rst:1164 msgid "Lists" msgstr "List（串列）" -#: ../../library/stdtypes.rst:1167 +#: ../../library/stdtypes.rst:1168 msgid "" "Lists are mutable sequences, typically used to store collections of " "homogeneous items (where the precise degree of similarity will vary by " "application)." msgstr "" -#: ../../library/stdtypes.rst:1173 +#: ../../library/stdtypes.rst:1174 msgid "Lists may be constructed in several ways:" msgstr "" -#: ../../library/stdtypes.rst:1175 +#: ../../library/stdtypes.rst:1176 msgid "Using a pair of square brackets to denote the empty list: ``[]``" msgstr "" -#: ../../library/stdtypes.rst:1176 +#: ../../library/stdtypes.rst:1177 msgid "" "Using square brackets, separating items with commas: ``[a]``, ``[a, b, c]``" msgstr "" -#: ../../library/stdtypes.rst:1177 +#: ../../library/stdtypes.rst:1178 msgid "Using a list comprehension: ``[x for x in iterable]``" msgstr "" -#: ../../library/stdtypes.rst:1178 +#: ../../library/stdtypes.rst:1179 msgid "Using the type constructor: ``list()`` or ``list(iterable)``" msgstr "" -#: ../../library/stdtypes.rst:1180 +#: ../../library/stdtypes.rst:1181 msgid "" "The constructor builds a list whose items are the same and in the same order " "as *iterable*'s items. *iterable* may be either a sequence, a container " @@ -1594,20 +1594,20 @@ msgid "" "new empty list, ``[]``." msgstr "" -#: ../../library/stdtypes.rst:1189 +#: ../../library/stdtypes.rst:1190 msgid "" "Many other operations also produce lists, including the :func:`sorted` built-" "in." msgstr "" -#: ../../library/stdtypes.rst:1192 +#: ../../library/stdtypes.rst:1193 msgid "" "Lists implement all of the :ref:`common ` and :ref:`mutable " "` sequence operations. Lists also provide the following " "additional method:" msgstr "" -#: ../../library/stdtypes.rst:1198 +#: ../../library/stdtypes.rst:1199 msgid "" "This method sorts the list in place, using only ``<`` comparisons between " "items. Exceptions are not suppressed - if any comparison operations fail, " @@ -1615,13 +1615,13 @@ msgid "" "partially modified state)." msgstr "" -#: ../../library/stdtypes.rst:1203 +#: ../../library/stdtypes.rst:1204 msgid "" ":meth:`sort` accepts two arguments that can only be passed by keyword (:ref:" "`keyword-only arguments `):" msgstr "" -#: ../../library/stdtypes.rst:1206 +#: ../../library/stdtypes.rst:1207 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each list element (for example, ``key=str.lower``). The " @@ -1630,19 +1630,19 @@ msgid "" "list items are sorted directly without calculating a separate key value." msgstr "" -#: ../../library/stdtypes.rst:1213 +#: ../../library/stdtypes.rst:1214 msgid "" "The :func:`functools.cmp_to_key` utility is available to convert a 2.x style " "*cmp* function to a *key* function." msgstr "" -#: ../../library/stdtypes.rst:1216 +#: ../../library/stdtypes.rst:1217 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." msgstr "" -#: ../../library/stdtypes.rst:1219 +#: ../../library/stdtypes.rst:1220 msgid "" "This method modifies the sequence in place for economy of space when sorting " "a large sequence. To remind users that it operates by side effect, it does " @@ -1650,7 +1650,7 @@ msgid "" "new sorted list instance)." msgstr "" -#: ../../library/stdtypes.rst:1224 +#: ../../library/stdtypes.rst:1225 msgid "" "The :meth:`sort` method is guaranteed to be stable. A sort is stable if it " "guarantees not to change the relative order of elements that compare equal " @@ -1658,12 +1658,12 @@ msgid "" "department, then by salary grade)." msgstr "" -#: ../../library/stdtypes.rst:1229 +#: ../../library/stdtypes.rst:1230 msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -#: ../../library/stdtypes.rst:1233 +#: ../../library/stdtypes.rst:1234 msgid "" "While a list is being sorted, the effect of attempting to mutate, or even " "inspect, the list is undefined. The C implementation of Python makes the " @@ -1671,11 +1671,11 @@ msgid "" "detect that the list has been mutated during a sort." msgstr "" -#: ../../library/stdtypes.rst:1242 +#: ../../library/stdtypes.rst:1243 msgid "Tuples" msgstr "" -#: ../../library/stdtypes.rst:1246 +#: ../../library/stdtypes.rst:1247 msgid "" "Tuples are immutable sequences, typically used to store collections of " "heterogeneous data (such as the 2-tuples produced by the :func:`enumerate` " @@ -1684,27 +1684,27 @@ msgid "" "class:`dict` instance)." msgstr "" -#: ../../library/stdtypes.rst:1254 +#: ../../library/stdtypes.rst:1255 msgid "Tuples may be constructed in a number of ways:" msgstr "" -#: ../../library/stdtypes.rst:1256 +#: ../../library/stdtypes.rst:1257 msgid "Using a pair of parentheses to denote the empty tuple: ``()``" msgstr "" -#: ../../library/stdtypes.rst:1257 +#: ../../library/stdtypes.rst:1258 msgid "Using a trailing comma for a singleton tuple: ``a,`` or ``(a,)``" msgstr "" -#: ../../library/stdtypes.rst:1258 +#: ../../library/stdtypes.rst:1259 msgid "Separating items with commas: ``a, b, c`` or ``(a, b, c)``" msgstr "" -#: ../../library/stdtypes.rst:1259 +#: ../../library/stdtypes.rst:1260 msgid "Using the :func:`tuple` built-in: ``tuple()`` or ``tuple(iterable)``" msgstr "" -#: ../../library/stdtypes.rst:1261 +#: ../../library/stdtypes.rst:1262 msgid "" "The constructor builds a tuple whose items are the same and in the same " "order as *iterable*'s items. *iterable* may be either a sequence, a " @@ -1715,7 +1715,7 @@ msgid "" "``()``." msgstr "" -#: ../../library/stdtypes.rst:1269 +#: ../../library/stdtypes.rst:1270 msgid "" "Note that it is actually the comma which makes a tuple, not the parentheses. " "The parentheses are optional, except in the empty tuple case, or when they " @@ -1724,30 +1724,30 @@ msgid "" "call with a 3-tuple as the sole argument." msgstr "" -#: ../../library/stdtypes.rst:1275 +#: ../../library/stdtypes.rst:1276 msgid "" "Tuples implement all of the :ref:`common ` sequence " "operations." msgstr "" -#: ../../library/stdtypes.rst:1278 +#: ../../library/stdtypes.rst:1279 msgid "" "For heterogeneous collections of data where access by name is clearer than " "access by index, :func:`collections.namedtuple` may be a more appropriate " "choice than a simple tuple object." msgstr "" -#: ../../library/stdtypes.rst:1286 +#: ../../library/stdtypes.rst:1287 msgid "Ranges" msgstr "" -#: ../../library/stdtypes.rst:1290 +#: ../../library/stdtypes.rst:1291 msgid "" "The :class:`range` type represents an immutable sequence of numbers and is " "commonly used for looping a specific number of times in :keyword:`for` loops." msgstr "" -#: ../../library/stdtypes.rst:1297 +#: ../../library/stdtypes.rst:1298 msgid "" "The arguments to the range constructor must be integers (either built-in :" "class:`int` or any object that implements the ``__index__`` special " @@ -1756,38 +1756,38 @@ msgid "" "`ValueError` is raised." msgstr "" -#: ../../library/stdtypes.rst:1303 +#: ../../library/stdtypes.rst:1304 msgid "" "For a positive *step*, the contents of a range ``r`` are determined by the " "formula ``r[i] = start + step*i`` where ``i >= 0`` and ``r[i] < stop``." msgstr "" -#: ../../library/stdtypes.rst:1307 +#: ../../library/stdtypes.rst:1308 msgid "" "For a negative *step*, the contents of the range are still determined by the " "formula ``r[i] = start + step*i``, but the constraints are ``i >= 0`` and " "``r[i] > stop``." msgstr "" -#: ../../library/stdtypes.rst:1311 +#: ../../library/stdtypes.rst:1312 msgid "" "A range object will be empty if ``r[0]`` does not meet the value constraint. " "Ranges do support negative indices, but these are interpreted as indexing " "from the end of the sequence determined by the positive indices." msgstr "" -#: ../../library/stdtypes.rst:1316 +#: ../../library/stdtypes.rst:1317 msgid "" "Ranges containing absolute values larger than :data:`sys.maxsize` are " "permitted but some features (such as :func:`len`) may raise :exc:" "`OverflowError`." msgstr "" -#: ../../library/stdtypes.rst:1320 +#: ../../library/stdtypes.rst:1321 msgid "Range examples::" msgstr "" -#: ../../library/stdtypes.rst:1337 +#: ../../library/stdtypes.rst:1338 msgid "" "Ranges implement all of the :ref:`common ` sequence " "operations except concatenation and repetition (due to the fact that range " @@ -1795,23 +1795,23 @@ msgid "" "repetition and concatenation will usually violate that pattern)." msgstr "" -#: ../../library/stdtypes.rst:1344 +#: ../../library/stdtypes.rst:1345 msgid "" "The value of the *start* parameter (or ``0`` if the parameter was not " "supplied)" msgstr "" -#: ../../library/stdtypes.rst:1349 +#: ../../library/stdtypes.rst:1350 msgid "The value of the *stop* parameter" msgstr "" -#: ../../library/stdtypes.rst:1353 +#: ../../library/stdtypes.rst:1354 msgid "" "The value of the *step* parameter (or ``1`` if the parameter was not " "supplied)" msgstr "" -#: ../../library/stdtypes.rst:1356 +#: ../../library/stdtypes.rst:1357 msgid "" "The advantage of the :class:`range` type over a regular :class:`list` or :" "class:`tuple` is that a :class:`range` object will always take the same " @@ -1820,14 +1820,14 @@ msgid "" "individual items and subranges as needed)." msgstr "" -#: ../../library/stdtypes.rst:1362 +#: ../../library/stdtypes.rst:1363 msgid "" "Range objects implement the :class:`collections.abc.Sequence` ABC, and " "provide features such as containment tests, element index lookup, slicing " "and support for negative indices (see :ref:`typesseq`):" msgstr "" -#: ../../library/stdtypes.rst:1382 +#: ../../library/stdtypes.rst:1383 msgid "" "Testing range objects for equality with ``==`` and ``!=`` compares them as " "sequences. That is, two range objects are considered equal if they " @@ -1837,111 +1837,111 @@ msgid "" "3)`` or ``range(0, 3, 2) == range(0, 4, 2)``.)" msgstr "" -#: ../../library/stdtypes.rst:1389 +#: ../../library/stdtypes.rst:1390 msgid "" "Implement the Sequence ABC. Support slicing and negative indices. Test :" "class:`int` objects for membership in constant time instead of iterating " "through all items." msgstr "" -#: ../../library/stdtypes.rst:1395 +#: ../../library/stdtypes.rst:1396 msgid "" "Define '==' and '!=' to compare range objects based on the sequence of " "values they define (instead of comparing based on object identity)." msgstr "" -#: ../../library/stdtypes.rst:1400 +#: ../../library/stdtypes.rst:1401 msgid "" "The :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " "attributes." msgstr "" -#: ../../library/stdtypes.rst:1406 +#: ../../library/stdtypes.rst:1407 msgid "" "The `linspace recipe `_ shows " "how to implement a lazy version of range suitable for floating point " "applications." msgstr "" -#: ../../library/stdtypes.rst:1418 +#: ../../library/stdtypes.rst:1419 msgid "Text Sequence Type --- :class:`str`" msgstr "" -#: ../../library/stdtypes.rst:1420 +#: ../../library/stdtypes.rst:1421 msgid "" "Textual data in Python is handled with :class:`str` objects, or :dfn:" "`strings`. Strings are immutable :ref:`sequences ` of Unicode code " "points. String literals are written in a variety of ways:" msgstr "" -#: ../../library/stdtypes.rst:1425 +#: ../../library/stdtypes.rst:1426 msgid "Single quotes: ``'allows embedded \"double\" quotes'``" msgstr "" -#: ../../library/stdtypes.rst:1426 +#: ../../library/stdtypes.rst:1427 msgid "Double quotes: ``\"allows embedded 'single' quotes\"``." msgstr "" -#: ../../library/stdtypes.rst:1427 +#: ../../library/stdtypes.rst:1428 msgid "" "Triple quoted: ``'''Three single quotes'''``, ``\"\"\"Three double quotes" "\"\"\"``" msgstr "" -#: ../../library/stdtypes.rst:1429 +#: ../../library/stdtypes.rst:1430 msgid "" "Triple quoted strings may span multiple lines - all associated whitespace " "will be included in the string literal." msgstr "" -#: ../../library/stdtypes.rst:1432 +#: ../../library/stdtypes.rst:1433 msgid "" "String literals that are part of a single expression and have only " "whitespace between them will be implicitly converted to a single string " "literal. That is, ``(\"spam \" \"eggs\") == \"spam eggs\"``." msgstr "" -#: ../../library/stdtypes.rst:1436 +#: ../../library/stdtypes.rst:1437 msgid "" "See :ref:`strings` for more about the various forms of string literal, " "including supported escape sequences, and the ``r`` (\"raw\") prefix that " "disables most escape sequence processing." msgstr "" -#: ../../library/stdtypes.rst:1440 +#: ../../library/stdtypes.rst:1441 msgid "" "Strings may also be created from other objects using the :class:`str` " "constructor." msgstr "" -#: ../../library/stdtypes.rst:1443 +#: ../../library/stdtypes.rst:1444 msgid "" "Since there is no separate \"character\" type, indexing a string produces " "strings of length 1. That is, for a non-empty string *s*, ``s[0] == s[0:1]``." msgstr "" -#: ../../library/stdtypes.rst:1449 +#: ../../library/stdtypes.rst:1450 msgid "" "There is also no mutable string type, but :meth:`str.join` or :class:`io." "StringIO` can be used to efficiently construct strings from multiple " "fragments." msgstr "" -#: ../../library/stdtypes.rst:1453 +#: ../../library/stdtypes.rst:1454 msgid "" "For backwards compatibility with the Python 2 series, the ``u`` prefix is " "once again permitted on string literals. It has no effect on the meaning of " "string literals and cannot be combined with the ``r`` prefix." msgstr "" -#: ../../library/stdtypes.rst:1465 +#: ../../library/stdtypes.rst:1466 msgid "" "Return a :ref:`string ` version of *object*. If *object* is not " "provided, returns the empty string. Otherwise, the behavior of ``str()`` " "depends on whether *encoding* or *errors* is given, as follows." msgstr "" -#: ../../library/stdtypes.rst:1469 +#: ../../library/stdtypes.rst:1470 msgid "" "If neither *encoding* nor *errors* is given, ``str(object)`` returns :meth:" "`object.__str__() `, which is the \"informal\" or nicely " @@ -1950,7 +1950,7 @@ msgid "" "method, then :func:`str` falls back to returning :meth:`repr(object) `." msgstr "" -#: ../../library/stdtypes.rst:1480 +#: ../../library/stdtypes.rst:1481 msgid "" "If at least one of *encoding* or *errors* is given, *object* should be a :" "term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " @@ -1962,7 +1962,7 @@ msgid "" "buffer objects." msgstr "" -#: ../../library/stdtypes.rst:1489 +#: ../../library/stdtypes.rst:1490 msgid "" "Passing a :class:`bytes` object to :func:`str` without the *encoding* or " "*errors* arguments falls under the first case of returning the informal " @@ -1970,7 +1970,7 @@ msgid "" "Python). For example::" msgstr "" -#: ../../library/stdtypes.rst:1497 +#: ../../library/stdtypes.rst:1498 msgid "" "For more information on the ``str`` class and its methods, see :ref:" "`textseq` and the :ref:`string-methods` section below. To output formatted " @@ -1978,17 +1978,17 @@ msgid "" "addition, see the :ref:`stringservices` section." msgstr "" -#: ../../library/stdtypes.rst:1509 +#: ../../library/stdtypes.rst:1510 msgid "String Methods" msgstr "" -#: ../../library/stdtypes.rst:1514 +#: ../../library/stdtypes.rst:1515 msgid "" "Strings implement all of the :ref:`common ` sequence " "operations, along with the additional methods described below." msgstr "" -#: ../../library/stdtypes.rst:1517 +#: ../../library/stdtypes.rst:1518 msgid "" "Strings also support two styles of string formatting, one providing a large " "degree of flexibility and customization (see :meth:`str.format`, :ref:" @@ -1998,33 +1998,33 @@ msgid "" "handle (:ref:`old-string-formatting`)." msgstr "" -#: ../../library/stdtypes.rst:1524 +#: ../../library/stdtypes.rst:1525 msgid "" "The :ref:`textservices` section of the standard library covers a number of " "other modules that provide various text related utilities (including regular " "expression support in the :mod:`re` module)." msgstr "" -#: ../../library/stdtypes.rst:1530 +#: ../../library/stdtypes.rst:1531 msgid "" "Return a copy of the string with its first character capitalized and the " "rest lowercased." msgstr "" -#: ../../library/stdtypes.rst:1533 +#: ../../library/stdtypes.rst:1534 msgid "" "The first character is now put into titlecase rather than uppercase. This " "means that characters like digraphs will only have their first letter " "capitalized, instead of the full character." msgstr "" -#: ../../library/stdtypes.rst:1540 +#: ../../library/stdtypes.rst:1541 msgid "" "Return a casefolded copy of the string. Casefolded strings may be used for " "caseless matching." msgstr "" -#: ../../library/stdtypes.rst:1543 +#: ../../library/stdtypes.rst:1544 msgid "" "Casefolding is similar to lowercasing but more aggressive because it is " "intended to remove all case distinctions in a string. For example, the " @@ -2033,27 +2033,27 @@ msgid "" "`casefold` converts it to ``\"ss\"``." msgstr "" -#: ../../library/stdtypes.rst:1549 +#: ../../library/stdtypes.rst:1550 msgid "" "The casefolding algorithm is described in section 3.13 of the Unicode " "Standard." msgstr "" -#: ../../library/stdtypes.rst:1557 +#: ../../library/stdtypes.rst:1558 msgid "" "Return centered in a string of length *width*. Padding is done using the " "specified *fillchar* (default is an ASCII space). The original string is " "returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:1565 +#: ../../library/stdtypes.rst:1566 msgid "" "Return the number of non-overlapping occurrences of substring *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" -#: ../../library/stdtypes.rst:1572 +#: ../../library/stdtypes.rst:1573 msgid "" "Return an encoded version of the string as a bytes object. Default encoding " "is ``'utf-8'``. *errors* may be given to set a different error handling " @@ -2065,24 +2065,24 @@ msgid "" "encodings`." msgstr "" -#: ../../library/stdtypes.rst:1581 +#: ../../library/stdtypes.rst:1582 msgid "" "By default, the *errors* argument is not checked for best performances, but " "only used at the first encoding error. Enable the :ref:`Python Development " "Mode `, or use a :ref:`debug build ` to check *errors*." msgstr "" -#: ../../library/stdtypes.rst:1586 +#: ../../library/stdtypes.rst:1587 msgid "Support for keyword arguments added." msgstr "" -#: ../../library/stdtypes.rst:1589 ../../library/stdtypes.rst:2725 +#: ../../library/stdtypes.rst:1590 ../../library/stdtypes.rst:2726 msgid "" "The *errors* is now checked in development mode and in :ref:`debug mode " "`." msgstr "" -#: ../../library/stdtypes.rst:1596 +#: ../../library/stdtypes.rst:1597 msgid "" "Return ``True`` if the string ends with the specified *suffix*, otherwise " "return ``False``. *suffix* can also be a tuple of suffixes to look for. " @@ -2090,7 +2090,7 @@ msgid "" "*end*, stop comparing at that position." msgstr "" -#: ../../library/stdtypes.rst:1604 +#: ../../library/stdtypes.rst:1605 msgid "" "Return a copy of the string where all tab characters are replaced by one or " "more spaces, depending on the current column and the given tab size. Tab " @@ -2106,21 +2106,21 @@ msgid "" "printed." msgstr "" -#: ../../library/stdtypes.rst:1625 +#: ../../library/stdtypes.rst:1626 msgid "" "Return the lowest index in the string where substring *sub* is found within " "the slice ``s[start:end]``. Optional arguments *start* and *end* are " "interpreted as in slice notation. Return ``-1`` if *sub* is not found." msgstr "" -#: ../../library/stdtypes.rst:1631 +#: ../../library/stdtypes.rst:1632 msgid "" "The :meth:`~str.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" -#: ../../library/stdtypes.rst:1641 +#: ../../library/stdtypes.rst:1642 msgid "" "Perform a string formatting operation. The string on which this method is " "called can contain literal text or replacement fields delimited by braces " @@ -2130,13 +2130,13 @@ msgid "" "the corresponding argument." msgstr "" -#: ../../library/stdtypes.rst:1651 +#: ../../library/stdtypes.rst:1652 msgid "" "See :ref:`formatstrings` for a description of the various formatting options " "that can be specified in format strings." msgstr "" -#: ../../library/stdtypes.rst:1655 +#: ../../library/stdtypes.rst:1656 msgid "" "When formatting a number (:class:`int`, :class:`float`, :class:`complex`, :" "class:`decimal.Decimal` and subclasses) with the ``n`` type (ex: ``'{:n}'." @@ -2147,26 +2147,26 @@ msgid "" "This temporary change affects other threads." msgstr "" -#: ../../library/stdtypes.rst:1664 +#: ../../library/stdtypes.rst:1665 msgid "" "When formatting a number with the ``n`` type, the function sets temporarily " "the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` locale in some cases." msgstr "" -#: ../../library/stdtypes.rst:1672 +#: ../../library/stdtypes.rst:1673 msgid "" "Similar to ``str.format(**mapping)``, except that ``mapping`` is used " "directly and not copied to a :class:`dict`. This is useful if for example " "``mapping`` is a dict subclass:" msgstr "" -#: ../../library/stdtypes.rst:1688 +#: ../../library/stdtypes.rst:1689 msgid "" "Like :meth:`~str.find`, but raise :exc:`ValueError` when the substring is " "not found." msgstr "" -#: ../../library/stdtypes.rst:1694 +#: ../../library/stdtypes.rst:1695 msgid "" "Return ``True`` if all characters in the string are alphanumeric and there " "is at least one character, ``False`` otherwise. A character ``c`` is " @@ -2174,7 +2174,7 @@ msgid "" "isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``." msgstr "" -#: ../../library/stdtypes.rst:1702 +#: ../../library/stdtypes.rst:1703 msgid "" "Return ``True`` if all characters in the string are alphabetic and there is " "at least one character, ``False`` otherwise. Alphabetic characters are " @@ -2184,14 +2184,14 @@ msgid "" "property defined in the Unicode Standard." msgstr "" -#: ../../library/stdtypes.rst:1711 +#: ../../library/stdtypes.rst:1712 msgid "" "Return ``True`` if the string is empty or all characters in the string are " "ASCII, ``False`` otherwise. ASCII characters have code points in the range U" "+0000-U+007F." msgstr "" -#: ../../library/stdtypes.rst:1720 +#: ../../library/stdtypes.rst:1721 msgid "" "Return ``True`` if all characters in the string are decimal characters and " "there is at least one character, ``False`` otherwise. Decimal characters are " @@ -2200,7 +2200,7 @@ msgid "" "General Category \"Nd\"." msgstr "" -#: ../../library/stdtypes.rst:1730 +#: ../../library/stdtypes.rst:1731 msgid "" "Return ``True`` if all characters in the string are digits and there is at " "least one character, ``False`` otherwise. Digits include decimal characters " @@ -2210,32 +2210,32 @@ msgid "" "property value Numeric_Type=Digit or Numeric_Type=Decimal." msgstr "" -#: ../../library/stdtypes.rst:1740 +#: ../../library/stdtypes.rst:1741 msgid "" "Return ``True`` if the string is a valid identifier according to the " "language definition, section :ref:`identifiers`." msgstr "" -#: ../../library/stdtypes.rst:1743 +#: ../../library/stdtypes.rst:1744 msgid "" "Call :func:`keyword.iskeyword` to test whether string ``s`` is a reserved " "identifier, such as :keyword:`def` and :keyword:`class`." msgstr "" -#: ../../library/stdtypes.rst:1746 +#: ../../library/stdtypes.rst:1747 msgid "Example: ::" msgstr "" "範例：\n" "\n" "::" -#: ../../library/stdtypes.rst:1759 +#: ../../library/stdtypes.rst:1760 msgid "" "Return ``True`` if all cased characters [4]_ in the string are lowercase and " "there is at least one cased character, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:1765 +#: ../../library/stdtypes.rst:1766 msgid "" "Return ``True`` if all characters in the string are numeric characters, and " "there is at least one character, ``False`` otherwise. Numeric characters " @@ -2245,7 +2245,7 @@ msgid "" "Numeric_Type=Decimal or Numeric_Type=Numeric." msgstr "" -#: ../../library/stdtypes.rst:1775 +#: ../../library/stdtypes.rst:1776 msgid "" "Return ``True`` if all characters in the string are printable or the string " "is empty, ``False`` otherwise. Nonprintable characters are those characters " @@ -2256,20 +2256,20 @@ msgid "" "of strings written to :data:`sys.stdout` or :data:`sys.stderr`.)" msgstr "" -#: ../../library/stdtypes.rst:1786 +#: ../../library/stdtypes.rst:1787 msgid "" "Return ``True`` if there are only whitespace characters in the string and " "there is at least one character, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:1789 +#: ../../library/stdtypes.rst:1790 msgid "" "A character is *whitespace* if in the Unicode character database (see :mod:" "`unicodedata`), either its general category is ``Zs`` (\"Separator, space" "\"), or its bidirectional class is one of ``WS``, ``B``, or ``S``." msgstr "" -#: ../../library/stdtypes.rst:1797 +#: ../../library/stdtypes.rst:1798 msgid "" "Return ``True`` if the string is a titlecased string and there is at least " "one character, for example uppercase characters may only follow uncased " @@ -2277,13 +2277,13 @@ msgid "" "otherwise." msgstr "" -#: ../../library/stdtypes.rst:1804 +#: ../../library/stdtypes.rst:1805 msgid "" "Return ``True`` if all cased characters [4]_ in the string are uppercase and " "there is at least one cased character, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:1820 +#: ../../library/stdtypes.rst:1821 msgid "" "Return a string which is the concatenation of the strings in *iterable*. A :" "exc:`TypeError` will be raised if there are any non-string values in " @@ -2291,26 +2291,26 @@ msgid "" "elements is the string providing this method." msgstr "" -#: ../../library/stdtypes.rst:1828 +#: ../../library/stdtypes.rst:1829 msgid "" "Return the string left justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:1835 +#: ../../library/stdtypes.rst:1836 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "lowercase." msgstr "" -#: ../../library/stdtypes.rst:1838 +#: ../../library/stdtypes.rst:1839 msgid "" "The lowercasing algorithm used is described in section 3.13 of the Unicode " "Standard." msgstr "" -#: ../../library/stdtypes.rst:1844 +#: ../../library/stdtypes.rst:1845 msgid "" "Return a copy of the string with leading characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -2319,19 +2319,19 @@ msgid "" "are stripped::" msgstr "" -#: ../../library/stdtypes.rst:1854 +#: ../../library/stdtypes.rst:1855 msgid "" "See :meth:`str.removeprefix` for a method that will remove a single prefix " "string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:1865 +#: ../../library/stdtypes.rst:1866 msgid "" "This static method returns a translation table usable for :meth:`str." "translate`." msgstr "" -#: ../../library/stdtypes.rst:1867 +#: ../../library/stdtypes.rst:1868 msgid "" "If there is only one argument, it must be a dictionary mapping Unicode " "ordinals (integers) or characters (strings of length 1) to Unicode ordinals, " @@ -2339,7 +2339,7 @@ msgid "" "converted to ordinals." msgstr "" -#: ../../library/stdtypes.rst:1872 +#: ../../library/stdtypes.rst:1873 msgid "" "If there are two arguments, they must be strings of equal length, and in the " "resulting dictionary, each character in x will be mapped to the character at " @@ -2347,7 +2347,7 @@ msgid "" "whose characters will be mapped to ``None`` in the result." msgstr "" -#: ../../library/stdtypes.rst:1880 +#: ../../library/stdtypes.rst:1881 msgid "" "Split the string at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -2355,47 +2355,47 @@ msgid "" "containing the string itself, followed by two empty strings." msgstr "" -#: ../../library/stdtypes.rst:1888 +#: ../../library/stdtypes.rst:1889 msgid "" "If the string starts with the *prefix* string, return " "``string[len(prefix):]``. Otherwise, return a copy of the original string::" msgstr "" -#: ../../library/stdtypes.rst:1902 +#: ../../library/stdtypes.rst:1903 msgid "" "If the string ends with the *suffix* string and that *suffix* is not empty, " "return ``string[:-len(suffix)]``. Otherwise, return a copy of the original " "string::" msgstr "" -#: ../../library/stdtypes.rst:1916 +#: ../../library/stdtypes.rst:1917 msgid "" "Return a copy of the string with all occurrences of substring *old* replaced " "by *new*. If the optional argument *count* is given, only the first *count* " "occurrences are replaced." msgstr "" -#: ../../library/stdtypes.rst:1923 +#: ../../library/stdtypes.rst:1924 msgid "" "Return the highest index in the string where substring *sub* is found, such " "that *sub* is contained within ``s[start:end]``. Optional arguments *start* " "and *end* are interpreted as in slice notation. Return ``-1`` on failure." msgstr "" -#: ../../library/stdtypes.rst:1930 +#: ../../library/stdtypes.rst:1931 msgid "" "Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " "not found." msgstr "" -#: ../../library/stdtypes.rst:1936 +#: ../../library/stdtypes.rst:1937 msgid "" "Return the string right justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:1943 +#: ../../library/stdtypes.rst:1944 msgid "" "Split the string at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -2403,7 +2403,7 @@ msgid "" "containing two empty strings, followed by the string itself." msgstr "" -#: ../../library/stdtypes.rst:1951 +#: ../../library/stdtypes.rst:1952 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done, the " @@ -2412,7 +2412,7 @@ msgid "" "behaves like :meth:`split` which is described in detail below." msgstr "" -#: ../../library/stdtypes.rst:1960 +#: ../../library/stdtypes.rst:1961 msgid "" "Return a copy of the string with trailing characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -2421,13 +2421,13 @@ msgid "" "are stripped::" msgstr "" -#: ../../library/stdtypes.rst:1970 +#: ../../library/stdtypes.rst:1971 msgid "" "See :meth:`str.removesuffix` for a method that will remove a single suffix " "string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:1980 +#: ../../library/stdtypes.rst:1981 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " @@ -2436,7 +2436,7 @@ msgid "" "possible splits are made)." msgstr "" -#: ../../library/stdtypes.rst:1986 +#: ../../library/stdtypes.rst:1987 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " @@ -2445,23 +2445,23 @@ msgid "" "Splitting an empty string with a specified separator returns ``['']``." msgstr "" -#: ../../library/stdtypes.rst:1992 ../../library/stdtypes.rst:2008 -#: ../../library/stdtypes.rst:2060 ../../library/stdtypes.rst:2128 -#: ../../library/stdtypes.rst:2191 ../../library/stdtypes.rst:3041 -#: ../../library/stdtypes.rst:3057 ../../library/stdtypes.rst:3148 -#: ../../library/stdtypes.rst:3164 ../../library/stdtypes.rst:3189 -#: ../../library/stdtypes.rst:3203 ../../library/stdtypes.rst:3231 -#: ../../library/stdtypes.rst:3245 ../../library/stdtypes.rst:3263 -#: ../../library/stdtypes.rst:3290 ../../library/stdtypes.rst:3313 -#: ../../library/stdtypes.rst:3340 ../../library/stdtypes.rst:3382 -#: ../../library/stdtypes.rst:3406 +#: ../../library/stdtypes.rst:1993 ../../library/stdtypes.rst:2009 +#: ../../library/stdtypes.rst:2061 ../../library/stdtypes.rst:2129 +#: ../../library/stdtypes.rst:2192 ../../library/stdtypes.rst:3042 +#: ../../library/stdtypes.rst:3058 ../../library/stdtypes.rst:3149 +#: ../../library/stdtypes.rst:3165 ../../library/stdtypes.rst:3190 +#: ../../library/stdtypes.rst:3204 ../../library/stdtypes.rst:3232 +#: ../../library/stdtypes.rst:3246 ../../library/stdtypes.rst:3264 +#: ../../library/stdtypes.rst:3291 ../../library/stdtypes.rst:3314 +#: ../../library/stdtypes.rst:3341 ../../library/stdtypes.rst:3383 +#: ../../library/stdtypes.rst:3407 msgid "For example::" msgstr "" "舉例來說：\n" "\n" "::" -#: ../../library/stdtypes.rst:2001 +#: ../../library/stdtypes.rst:2002 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive whitespace are regarded as a single separator, " @@ -2471,131 +2471,131 @@ msgid "" "returns ``[]``." msgstr "" -#: ../../library/stdtypes.rst:2023 +#: ../../library/stdtypes.rst:2024 msgid "" "Return a list of the lines in the string, breaking at line boundaries. Line " "breaks are not included in the resulting list unless *keepends* is given and " "true." msgstr "" -#: ../../library/stdtypes.rst:2027 +#: ../../library/stdtypes.rst:2028 msgid "" "This method splits on the following line boundaries. In particular, the " "boundaries are a superset of :term:`universal newlines`." msgstr "" -#: ../../library/stdtypes.rst:2031 +#: ../../library/stdtypes.rst:2032 msgid "Representation" msgstr "" -#: ../../library/stdtypes.rst:2031 +#: ../../library/stdtypes.rst:2032 msgid "Description" msgstr "描述" -#: ../../library/stdtypes.rst:2033 +#: ../../library/stdtypes.rst:2034 msgid "``\\n``" msgstr "``\\n``" -#: ../../library/stdtypes.rst:2033 +#: ../../library/stdtypes.rst:2034 msgid "Line Feed" msgstr "" -#: ../../library/stdtypes.rst:2035 +#: ../../library/stdtypes.rst:2036 msgid "``\\r``" msgstr "``\\r``" -#: ../../library/stdtypes.rst:2035 +#: ../../library/stdtypes.rst:2036 msgid "Carriage Return" msgstr "" -#: ../../library/stdtypes.rst:2037 +#: ../../library/stdtypes.rst:2038 msgid "``\\r\\n``" msgstr "``\\r\\n``" -#: ../../library/stdtypes.rst:2037 +#: ../../library/stdtypes.rst:2038 msgid "Carriage Return + Line Feed" msgstr "" -#: ../../library/stdtypes.rst:2039 +#: ../../library/stdtypes.rst:2040 msgid "``\\v`` or ``\\x0b``" msgstr "``\\v`` 或 ``\\x0b``" -#: ../../library/stdtypes.rst:2039 +#: ../../library/stdtypes.rst:2040 msgid "Line Tabulation" msgstr "" -#: ../../library/stdtypes.rst:2041 +#: ../../library/stdtypes.rst:2042 msgid "``\\f`` or ``\\x0c``" msgstr "``\\f`` 或 ``\\x0c``" -#: ../../library/stdtypes.rst:2041 +#: ../../library/stdtypes.rst:2042 msgid "Form Feed" msgstr "" -#: ../../library/stdtypes.rst:2043 +#: ../../library/stdtypes.rst:2044 msgid "``\\x1c``" msgstr "``\\x1c``" -#: ../../library/stdtypes.rst:2043 +#: ../../library/stdtypes.rst:2044 msgid "File Separator" msgstr "" -#: ../../library/stdtypes.rst:2045 +#: ../../library/stdtypes.rst:2046 msgid "``\\x1d``" msgstr "``\\x1d``" -#: ../../library/stdtypes.rst:2045 +#: ../../library/stdtypes.rst:2046 msgid "Group Separator" msgstr "" -#: ../../library/stdtypes.rst:2047 +#: ../../library/stdtypes.rst:2048 msgid "``\\x1e``" msgstr "``\\x1e``" -#: ../../library/stdtypes.rst:2047 +#: ../../library/stdtypes.rst:2048 msgid "Record Separator" msgstr "" -#: ../../library/stdtypes.rst:2049 +#: ../../library/stdtypes.rst:2050 msgid "``\\x85``" msgstr "``\\x85``" -#: ../../library/stdtypes.rst:2049 +#: ../../library/stdtypes.rst:2050 msgid "Next Line (C1 Control Code)" msgstr "" -#: ../../library/stdtypes.rst:2051 +#: ../../library/stdtypes.rst:2052 msgid "``\\u2028``" msgstr "``\\u2028``" -#: ../../library/stdtypes.rst:2051 +#: ../../library/stdtypes.rst:2052 msgid "Line Separator" msgstr "" -#: ../../library/stdtypes.rst:2053 +#: ../../library/stdtypes.rst:2054 msgid "``\\u2029``" msgstr "``\\u2029``" -#: ../../library/stdtypes.rst:2053 +#: ../../library/stdtypes.rst:2054 msgid "Paragraph Separator" msgstr "" -#: ../../library/stdtypes.rst:2058 +#: ../../library/stdtypes.rst:2059 msgid "``\\v`` and ``\\f`` added to list of line boundaries." msgstr "" -#: ../../library/stdtypes.rst:2067 +#: ../../library/stdtypes.rst:2068 msgid "" "Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" -#: ../../library/stdtypes.rst:2076 +#: ../../library/stdtypes.rst:2077 msgid "For comparison, ``split('\\n')`` gives::" msgstr "" -#: ../../library/stdtypes.rst:2086 +#: ../../library/stdtypes.rst:2087 msgid "" "Return ``True`` if string starts with the *prefix*, otherwise return " "``False``. *prefix* can also be a tuple of prefixes to look for. With " @@ -2603,7 +2603,7 @@ msgid "" "*end*, stop comparing string at that position." msgstr "" -#: ../../library/stdtypes.rst:2094 +#: ../../library/stdtypes.rst:2095 msgid "" "Return a copy of the string with the leading and trailing characters " "removed. The *chars* argument is a string specifying the set of characters " @@ -2612,7 +2612,7 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:2105 +#: ../../library/stdtypes.rst:2106 msgid "" "The outermost leading and trailing *chars* argument values are stripped from " "the string. Characters are removed from the leading end until reaching a " @@ -2620,20 +2620,20 @@ msgid "" "A similar action takes place on the trailing end. For example::" msgstr "" -#: ../../library/stdtypes.rst:2118 +#: ../../library/stdtypes.rst:2119 msgid "" "Return a copy of the string with uppercase characters converted to lowercase " "and vice versa. Note that it is not necessarily true that ``s.swapcase()." "swapcase() == s``." msgstr "" -#: ../../library/stdtypes.rst:2125 +#: ../../library/stdtypes.rst:2126 msgid "" "Return a titlecased version of the string where words start with an " "uppercase character and the remaining characters are lowercase." msgstr "" -#: ../../library/stdtypes.rst:2133 ../../library/stdtypes.rst:3350 +#: ../../library/stdtypes.rst:2134 ../../library/stdtypes.rst:3351 msgid "" "The algorithm uses a simple language-independent definition of a word as " "groups of consecutive letters. The definition works in many contexts but it " @@ -2641,12 +2641,12 @@ msgid "" "which may not be the desired result::" msgstr "" -#: ../../library/stdtypes.rst:2141 ../../library/stdtypes.rst:3358 +#: ../../library/stdtypes.rst:2142 ../../library/stdtypes.rst:3359 msgid "" "A workaround for apostrophes can be constructed using regular expressions::" msgstr "" -#: ../../library/stdtypes.rst:2155 +#: ../../library/stdtypes.rst:2156 msgid "" "Return a copy of the string in which each character has been mapped through " "the given translation table. The table must be an object that implements " @@ -2658,19 +2658,19 @@ msgid "" "exception, to map the character to itself." msgstr "" -#: ../../library/stdtypes.rst:2164 +#: ../../library/stdtypes.rst:2165 msgid "" "You can use :meth:`str.maketrans` to create a translation map from character-" "to-character mappings in different formats." msgstr "" -#: ../../library/stdtypes.rst:2167 +#: ../../library/stdtypes.rst:2168 msgid "" "See also the :mod:`codecs` module for a more flexible approach to custom " "character mappings." msgstr "" -#: ../../library/stdtypes.rst:2173 +#: ../../library/stdtypes.rst:2174 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "uppercase. Note that ``s.upper().isupper()`` might be ``False`` if ``s`` " @@ -2679,13 +2679,13 @@ msgid "" "titlecase)." msgstr "" -#: ../../library/stdtypes.rst:2179 +#: ../../library/stdtypes.rst:2180 msgid "" "The uppercasing algorithm used is described in section 3.13 of the Unicode " "Standard." msgstr "" -#: ../../library/stdtypes.rst:2185 +#: ../../library/stdtypes.rst:2186 msgid "" "Return a copy of the string left filled with ASCII ``'0'`` digits to make a " "string of length *width*. A leading sign prefix (``'+'``/``'-'``) is handled " @@ -2693,11 +2693,11 @@ msgid "" "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:2203 +#: ../../library/stdtypes.rst:2204 msgid "``printf``-style String Formatting" msgstr "" -#: ../../library/stdtypes.rst:2216 +#: ../../library/stdtypes.rst:2217 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -2708,7 +2708,7 @@ msgid "" "or extensibility." msgstr "" -#: ../../library/stdtypes.rst:2224 +#: ../../library/stdtypes.rst:2225 msgid "" "String objects have one unique built-in operation: the ``%`` operator " "(modulo). This is also known as the string *formatting* or *interpolation* " @@ -2718,7 +2718,7 @@ msgid "" "in the C language." msgstr "" -#: ../../library/stdtypes.rst:2230 +#: ../../library/stdtypes.rst:2231 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -2726,36 +2726,36 @@ msgid "" "example, a dictionary)." msgstr "" -#: ../../library/stdtypes.rst:2240 ../../library/stdtypes.rst:3461 +#: ../../library/stdtypes.rst:2241 ../../library/stdtypes.rst:3462 msgid "" "A conversion specifier contains two or more characters and has the following " "components, which must occur in this order:" msgstr "" -#: ../../library/stdtypes.rst:2243 ../../library/stdtypes.rst:3464 +#: ../../library/stdtypes.rst:2244 ../../library/stdtypes.rst:3465 msgid "The ``'%'`` character, which marks the start of the specifier." msgstr "" -#: ../../library/stdtypes.rst:2245 ../../library/stdtypes.rst:3466 +#: ../../library/stdtypes.rst:2246 ../../library/stdtypes.rst:3467 msgid "" "Mapping key (optional), consisting of a parenthesised sequence of characters " "(for example, ``(somename)``)." msgstr "" -#: ../../library/stdtypes.rst:2248 ../../library/stdtypes.rst:3469 +#: ../../library/stdtypes.rst:2249 ../../library/stdtypes.rst:3470 msgid "" "Conversion flags (optional), which affect the result of some conversion " "types." msgstr "" -#: ../../library/stdtypes.rst:2251 ../../library/stdtypes.rst:3472 +#: ../../library/stdtypes.rst:2252 ../../library/stdtypes.rst:3473 msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " "actual width is read from the next element of the tuple in *values*, and the " "object to convert comes after the minimum field width and optional precision." msgstr "" -#: ../../library/stdtypes.rst:2255 ../../library/stdtypes.rst:3476 +#: ../../library/stdtypes.rst:2256 ../../library/stdtypes.rst:3477 msgid "" "Precision (optional), given as a ``'.'`` (dot) followed by the precision. " "If specified as ``'*'`` (an asterisk), the actual precision is read from the " @@ -2763,15 +2763,15 @@ msgid "" "the precision." msgstr "" -#: ../../library/stdtypes.rst:2260 ../../library/stdtypes.rst:3481 +#: ../../library/stdtypes.rst:2261 ../../library/stdtypes.rst:3482 msgid "Length modifier (optional)." msgstr "" -#: ../../library/stdtypes.rst:2262 ../../library/stdtypes.rst:3483 +#: ../../library/stdtypes.rst:2263 ../../library/stdtypes.rst:3484 msgid "Conversion type." msgstr "" -#: ../../library/stdtypes.rst:2264 +#: ../../library/stdtypes.rst:2265 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the string *must* include a parenthesised mapping key into that " @@ -2779,279 +2779,279 @@ msgid "" "selects the value to be formatted from the mapping. For example:" msgstr "" -#: ../../library/stdtypes.rst:2273 ../../library/stdtypes.rst:3494 +#: ../../library/stdtypes.rst:2274 ../../library/stdtypes.rst:3495 msgid "" "In this case no ``*`` specifiers may occur in a format (since they require a " "sequential parameter list)." msgstr "" -#: ../../library/stdtypes.rst:2276 ../../library/stdtypes.rst:3497 +#: ../../library/stdtypes.rst:2277 ../../library/stdtypes.rst:3498 msgid "The conversion flag characters are:" msgstr "" -#: ../../library/stdtypes.rst:2285 ../../library/stdtypes.rst:3506 +#: ../../library/stdtypes.rst:2286 ../../library/stdtypes.rst:3507 msgid "Flag" msgstr "" -#: ../../library/stdtypes.rst:2287 ../../library/stdtypes.rst:3508 +#: ../../library/stdtypes.rst:2288 ../../library/stdtypes.rst:3509 msgid "``'#'``" msgstr "``'#'``" -#: ../../library/stdtypes.rst:2287 ../../library/stdtypes.rst:3508 +#: ../../library/stdtypes.rst:2288 ../../library/stdtypes.rst:3509 msgid "" "The value conversion will use the \"alternate form\" (where defined below)." msgstr "" -#: ../../library/stdtypes.rst:2290 ../../library/stdtypes.rst:3511 +#: ../../library/stdtypes.rst:2291 ../../library/stdtypes.rst:3512 msgid "``'0'``" msgstr "``'0'``" -#: ../../library/stdtypes.rst:2290 ../../library/stdtypes.rst:3511 +#: ../../library/stdtypes.rst:2291 ../../library/stdtypes.rst:3512 msgid "The conversion will be zero padded for numeric values." msgstr "" -#: ../../library/stdtypes.rst:2292 ../../library/stdtypes.rst:3513 +#: ../../library/stdtypes.rst:2293 ../../library/stdtypes.rst:3514 msgid "``'-'``" msgstr "``'-'``" -#: ../../library/stdtypes.rst:2292 ../../library/stdtypes.rst:3513 +#: ../../library/stdtypes.rst:2293 ../../library/stdtypes.rst:3514 msgid "" "The converted value is left adjusted (overrides the ``'0'`` conversion if " "both are given)." msgstr "" -#: ../../library/stdtypes.rst:2295 ../../library/stdtypes.rst:3516 +#: ../../library/stdtypes.rst:2296 ../../library/stdtypes.rst:3517 msgid "``' '``" msgstr "``' '``" -#: ../../library/stdtypes.rst:2295 ../../library/stdtypes.rst:3516 +#: ../../library/stdtypes.rst:2296 ../../library/stdtypes.rst:3517 msgid "" "(a space) A blank should be left before a positive number (or empty string) " "produced by a signed conversion." msgstr "" -#: ../../library/stdtypes.rst:2298 ../../library/stdtypes.rst:3519 +#: ../../library/stdtypes.rst:2299 ../../library/stdtypes.rst:3520 msgid "``'+'``" msgstr "``'+'``" -#: ../../library/stdtypes.rst:2298 ../../library/stdtypes.rst:3519 +#: ../../library/stdtypes.rst:2299 ../../library/stdtypes.rst:3520 msgid "" "A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " "a \"space\" flag)." msgstr "" -#: ../../library/stdtypes.rst:2302 ../../library/stdtypes.rst:3523 +#: ../../library/stdtypes.rst:2303 ../../library/stdtypes.rst:3524 msgid "" "A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " "it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." msgstr "" -#: ../../library/stdtypes.rst:2305 ../../library/stdtypes.rst:3526 +#: ../../library/stdtypes.rst:2306 ../../library/stdtypes.rst:3527 msgid "The conversion types are:" msgstr "" -#: ../../library/stdtypes.rst:2308 ../../library/stdtypes.rst:3529 +#: ../../library/stdtypes.rst:2309 ../../library/stdtypes.rst:3530 msgid "Conversion" msgstr "" -#: ../../library/stdtypes.rst:2310 ../../library/stdtypes.rst:3531 +#: ../../library/stdtypes.rst:2311 ../../library/stdtypes.rst:3532 msgid "``'d'``" msgstr "``'d'``" -#: ../../library/stdtypes.rst:2310 ../../library/stdtypes.rst:2312 -#: ../../library/stdtypes.rst:3531 ../../library/stdtypes.rst:3533 +#: ../../library/stdtypes.rst:2311 ../../library/stdtypes.rst:2313 +#: ../../library/stdtypes.rst:3532 ../../library/stdtypes.rst:3534 msgid "Signed integer decimal." msgstr "" -#: ../../library/stdtypes.rst:2312 ../../library/stdtypes.rst:3533 +#: ../../library/stdtypes.rst:2313 ../../library/stdtypes.rst:3534 msgid "``'i'``" msgstr "``'i'``" -#: ../../library/stdtypes.rst:2314 ../../library/stdtypes.rst:3535 +#: ../../library/stdtypes.rst:2315 ../../library/stdtypes.rst:3536 msgid "``'o'``" msgstr "``'o'``" -#: ../../library/stdtypes.rst:2314 ../../library/stdtypes.rst:3535 +#: ../../library/stdtypes.rst:2315 ../../library/stdtypes.rst:3536 msgid "Signed octal value." msgstr "" -#: ../../library/stdtypes.rst:2316 ../../library/stdtypes.rst:3537 +#: ../../library/stdtypes.rst:2317 ../../library/stdtypes.rst:3538 msgid "``'u'``" msgstr "``'u'``" -#: ../../library/stdtypes.rst:2316 ../../library/stdtypes.rst:3537 +#: ../../library/stdtypes.rst:2317 ../../library/stdtypes.rst:3538 msgid "Obsolete type -- it is identical to ``'d'``." msgstr "" -#: ../../library/stdtypes.rst:2318 ../../library/stdtypes.rst:3539 +#: ../../library/stdtypes.rst:2319 ../../library/stdtypes.rst:3540 msgid "``'x'``" msgstr "``'x'``" -#: ../../library/stdtypes.rst:2318 ../../library/stdtypes.rst:3539 +#: ../../library/stdtypes.rst:2319 ../../library/stdtypes.rst:3540 msgid "Signed hexadecimal (lowercase)." msgstr "" -#: ../../library/stdtypes.rst:2320 ../../library/stdtypes.rst:3541 +#: ../../library/stdtypes.rst:2321 ../../library/stdtypes.rst:3542 msgid "``'X'``" msgstr "``'X'``" -#: ../../library/stdtypes.rst:2320 ../../library/stdtypes.rst:3541 +#: ../../library/stdtypes.rst:2321 ../../library/stdtypes.rst:3542 msgid "Signed hexadecimal (uppercase)." msgstr "" -#: ../../library/stdtypes.rst:2322 ../../library/stdtypes.rst:3543 +#: ../../library/stdtypes.rst:2323 ../../library/stdtypes.rst:3544 msgid "``'e'``" msgstr "``'e'``" -#: ../../library/stdtypes.rst:2322 ../../library/stdtypes.rst:3543 +#: ../../library/stdtypes.rst:2323 ../../library/stdtypes.rst:3544 msgid "Floating point exponential format (lowercase)." msgstr "" -#: ../../library/stdtypes.rst:2324 ../../library/stdtypes.rst:3545 +#: ../../library/stdtypes.rst:2325 ../../library/stdtypes.rst:3546 msgid "``'E'``" msgstr "``'E'``" -#: ../../library/stdtypes.rst:2324 ../../library/stdtypes.rst:3545 +#: ../../library/stdtypes.rst:2325 ../../library/stdtypes.rst:3546 msgid "Floating point exponential format (uppercase)." msgstr "" -#: ../../library/stdtypes.rst:2326 ../../library/stdtypes.rst:3547 +#: ../../library/stdtypes.rst:2327 ../../library/stdtypes.rst:3548 msgid "``'f'``" msgstr "``'f'``" -#: ../../library/stdtypes.rst:2326 ../../library/stdtypes.rst:2328 -#: ../../library/stdtypes.rst:3547 ../../library/stdtypes.rst:3549 +#: ../../library/stdtypes.rst:2327 ../../library/stdtypes.rst:2329 +#: ../../library/stdtypes.rst:3548 ../../library/stdtypes.rst:3550 msgid "Floating point decimal format." msgstr "" -#: ../../library/stdtypes.rst:2328 ../../library/stdtypes.rst:3549 +#: ../../library/stdtypes.rst:2329 ../../library/stdtypes.rst:3550 msgid "``'F'``" msgstr "``'F'``" -#: ../../library/stdtypes.rst:2330 ../../library/stdtypes.rst:3551 +#: ../../library/stdtypes.rst:2331 ../../library/stdtypes.rst:3552 msgid "``'g'``" msgstr "``'g'``" -#: ../../library/stdtypes.rst:2330 ../../library/stdtypes.rst:3551 +#: ../../library/stdtypes.rst:2331 ../../library/stdtypes.rst:3552 msgid "" "Floating point format. Uses lowercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: ../../library/stdtypes.rst:2334 ../../library/stdtypes.rst:3555 +#: ../../library/stdtypes.rst:2335 ../../library/stdtypes.rst:3556 msgid "``'G'``" msgstr "``'G'``" -#: ../../library/stdtypes.rst:2334 ../../library/stdtypes.rst:3555 +#: ../../library/stdtypes.rst:2335 ../../library/stdtypes.rst:3556 msgid "" "Floating point format. Uses uppercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: ../../library/stdtypes.rst:2338 ../../library/stdtypes.rst:3559 +#: ../../library/stdtypes.rst:2339 ../../library/stdtypes.rst:3560 msgid "``'c'``" msgstr "``'c'``" -#: ../../library/stdtypes.rst:2338 +#: ../../library/stdtypes.rst:2339 msgid "Single character (accepts integer or single character string)." msgstr "" -#: ../../library/stdtypes.rst:2341 ../../library/stdtypes.rst:3572 +#: ../../library/stdtypes.rst:2342 ../../library/stdtypes.rst:3573 msgid "``'r'``" msgstr "``'r'``" -#: ../../library/stdtypes.rst:2341 +#: ../../library/stdtypes.rst:2342 msgid "String (converts any Python object using :func:`repr`)." msgstr "" -#: ../../library/stdtypes.rst:2344 ../../library/stdtypes.rst:3566 +#: ../../library/stdtypes.rst:2345 ../../library/stdtypes.rst:3567 msgid "``'s'``" msgstr "``'s'``" -#: ../../library/stdtypes.rst:2344 +#: ../../library/stdtypes.rst:2345 msgid "String (converts any Python object using :func:`str`)." msgstr "" -#: ../../library/stdtypes.rst:2347 ../../library/stdtypes.rst:3569 +#: ../../library/stdtypes.rst:2348 ../../library/stdtypes.rst:3570 msgid "``'a'``" msgstr "``'a'``" -#: ../../library/stdtypes.rst:2347 +#: ../../library/stdtypes.rst:2348 msgid "String (converts any Python object using :func:`ascii`)." msgstr "" -#: ../../library/stdtypes.rst:2350 ../../library/stdtypes.rst:3575 +#: ../../library/stdtypes.rst:2351 ../../library/stdtypes.rst:3576 msgid "``'%'``" msgstr "``'%'``" -#: ../../library/stdtypes.rst:2350 ../../library/stdtypes.rst:3575 +#: ../../library/stdtypes.rst:2351 ../../library/stdtypes.rst:3576 msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" -#: ../../library/stdtypes.rst:2357 ../../library/stdtypes.rst:3582 +#: ../../library/stdtypes.rst:2358 ../../library/stdtypes.rst:3583 msgid "" "The alternate form causes a leading octal specifier (``'0o'``) to be " "inserted before the first digit." msgstr "" -#: ../../library/stdtypes.rst:2361 ../../library/stdtypes.rst:3586 +#: ../../library/stdtypes.rst:2362 ../../library/stdtypes.rst:3587 msgid "" "The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " "whether the ``'x'`` or ``'X'`` format was used) to be inserted before the " "first digit." msgstr "" -#: ../../library/stdtypes.rst:2365 ../../library/stdtypes.rst:3590 +#: ../../library/stdtypes.rst:2366 ../../library/stdtypes.rst:3591 msgid "" "The alternate form causes the result to always contain a decimal point, even " "if no digits follow it." msgstr "" -#: ../../library/stdtypes.rst:2368 ../../library/stdtypes.rst:3593 +#: ../../library/stdtypes.rst:2369 ../../library/stdtypes.rst:3594 msgid "" "The precision determines the number of digits after the decimal point and " "defaults to 6." msgstr "" -#: ../../library/stdtypes.rst:2372 ../../library/stdtypes.rst:3597 +#: ../../library/stdtypes.rst:2373 ../../library/stdtypes.rst:3598 msgid "" "The alternate form causes the result to always contain a decimal point, and " "trailing zeroes are not removed as they would otherwise be." msgstr "" -#: ../../library/stdtypes.rst:2375 ../../library/stdtypes.rst:3600 +#: ../../library/stdtypes.rst:2376 ../../library/stdtypes.rst:3601 msgid "" "The precision determines the number of significant digits before and after " "the decimal point and defaults to 6." msgstr "" -#: ../../library/stdtypes.rst:2379 ../../library/stdtypes.rst:3604 +#: ../../library/stdtypes.rst:2380 ../../library/stdtypes.rst:3605 msgid "If precision is ``N``, the output is truncated to ``N`` characters." msgstr "" -#: ../../library/stdtypes.rst:2382 ../../library/stdtypes.rst:3613 +#: ../../library/stdtypes.rst:2383 ../../library/stdtypes.rst:3614 msgid "See :pep:`237`." msgstr "" -#: ../../library/stdtypes.rst:2384 +#: ../../library/stdtypes.rst:2385 msgid "" "Since Python strings have an explicit length, ``%s`` conversions do not " "assume that ``'\\0'`` is the end of the string." msgstr "" -#: ../../library/stdtypes.rst:2389 +#: ../../library/stdtypes.rst:2390 msgid "" "``%f`` conversions for numbers whose absolute value is over 1e50 are no " "longer replaced by ``%g`` conversions." msgstr "" -#: ../../library/stdtypes.rst:2400 +#: ../../library/stdtypes.rst:2401 msgid "" "Binary Sequence Types --- :class:`bytes`, :class:`bytearray`, :class:" "`memoryview`" msgstr "" -#: ../../library/stdtypes.rst:2408 +#: ../../library/stdtypes.rst:2409 msgid "" "The core built-in types for manipulating binary data are :class:`bytes` and :" "class:`bytearray`. They are supported by :class:`memoryview` which uses the :" @@ -3059,17 +3059,17 @@ msgid "" "objects without needing to make a copy." msgstr "" -#: ../../library/stdtypes.rst:2413 +#: ../../library/stdtypes.rst:2414 msgid "" "The :mod:`array` module supports efficient storage of basic data types like " "32-bit integers and IEEE754 double-precision floating values." msgstr "" -#: ../../library/stdtypes.rst:2419 +#: ../../library/stdtypes.rst:2420 msgid "Bytes Objects" msgstr "" -#: ../../library/stdtypes.rst:2423 +#: ../../library/stdtypes.rst:2424 msgid "" "Bytes objects are immutable sequences of single bytes. Since many major " "binary protocols are based on the ASCII text encoding, bytes objects offer " @@ -3077,40 +3077,40 @@ msgid "" "and are closely related to string objects in a variety of other ways." msgstr "" -#: ../../library/stdtypes.rst:2430 +#: ../../library/stdtypes.rst:2431 msgid "" "Firstly, the syntax for bytes literals is largely the same as that for " "string literals, except that a ``b`` prefix is added:" msgstr "" -#: ../../library/stdtypes.rst:2433 +#: ../../library/stdtypes.rst:2434 msgid "Single quotes: ``b'still allows embedded \"double\" quotes'``" msgstr "" -#: ../../library/stdtypes.rst:2434 +#: ../../library/stdtypes.rst:2435 msgid "Double quotes: ``b\"still allows embedded 'single' quotes\"``." msgstr "" -#: ../../library/stdtypes.rst:2435 +#: ../../library/stdtypes.rst:2436 msgid "" "Triple quoted: ``b'''3 single quotes'''``, ``b\"\"\"3 double quotes\"\"\"``" msgstr "" -#: ../../library/stdtypes.rst:2437 +#: ../../library/stdtypes.rst:2438 msgid "" "Only ASCII characters are permitted in bytes literals (regardless of the " "declared source code encoding). Any binary values over 127 must be entered " "into bytes literals using the appropriate escape sequence." msgstr "" -#: ../../library/stdtypes.rst:2441 +#: ../../library/stdtypes.rst:2442 msgid "" "As with string literals, bytes literals may also use a ``r`` prefix to " "disable processing of escape sequences. See :ref:`strings` for more about " "the various forms of bytes literal, including supported escape sequences." msgstr "" -#: ../../library/stdtypes.rst:2445 +#: ../../library/stdtypes.rst:2446 msgid "" "While bytes literals and representations are based on ASCII text, bytes " "objects actually behave like immutable sequences of integers, with each " @@ -3123,29 +3123,29 @@ msgid "" "compatible will usually lead to data corruption)." msgstr "" -#: ../../library/stdtypes.rst:2455 +#: ../../library/stdtypes.rst:2456 msgid "" "In addition to the literal forms, bytes objects can be created in a number " "of other ways:" msgstr "" -#: ../../library/stdtypes.rst:2458 +#: ../../library/stdtypes.rst:2459 msgid "A zero-filled bytes object of a specified length: ``bytes(10)``" msgstr "" -#: ../../library/stdtypes.rst:2459 +#: ../../library/stdtypes.rst:2460 msgid "From an iterable of integers: ``bytes(range(20))``" msgstr "" -#: ../../library/stdtypes.rst:2460 +#: ../../library/stdtypes.rst:2461 msgid "Copying existing binary data via the buffer protocol: ``bytes(obj)``" msgstr "" -#: ../../library/stdtypes.rst:2462 +#: ../../library/stdtypes.rst:2463 msgid "Also see the :ref:`bytes ` built-in." msgstr "" -#: ../../library/stdtypes.rst:2464 +#: ../../library/stdtypes.rst:2465 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -3153,32 +3153,32 @@ msgid "" "that format:" msgstr "" -#: ../../library/stdtypes.rst:2470 +#: ../../library/stdtypes.rst:2471 msgid "" "This :class:`bytes` class method returns a bytes object, decoding the given " "string object. The string must contain two hexadecimal digits per byte, " "with ASCII whitespace being ignored." msgstr "" -#: ../../library/stdtypes.rst:2477 +#: ../../library/stdtypes.rst:2478 msgid "" ":meth:`bytes.fromhex` now skips all ASCII whitespace in the string, not just " "spaces." msgstr "" -#: ../../library/stdtypes.rst:2481 +#: ../../library/stdtypes.rst:2482 msgid "" "A reverse conversion function exists to transform a bytes object into its " "hexadecimal representation." msgstr "" -#: ../../library/stdtypes.rst:2486 ../../library/stdtypes.rst:2580 +#: ../../library/stdtypes.rst:2487 ../../library/stdtypes.rst:2581 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the instance." msgstr "" -#: ../../library/stdtypes.rst:2492 +#: ../../library/stdtypes.rst:2493 msgid "" "If you want to make the hex string easier to read, you can specify a single " "character separator *sep* parameter to include in the output. By default " @@ -3187,13 +3187,13 @@ msgid "" "negative values from the left." msgstr "" -#: ../../library/stdtypes.rst:2508 +#: ../../library/stdtypes.rst:2509 msgid "" ":meth:`bytes.hex` now supports optional *sep* and *bytes_per_sep* parameters " "to insert separators between bytes in the hex output." msgstr "" -#: ../../library/stdtypes.rst:2512 +#: ../../library/stdtypes.rst:2513 msgid "" "Since bytes objects are sequences of integers (akin to a tuple), for a bytes " "object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be a bytes " @@ -3201,14 +3201,14 @@ msgid "" "and slicing will produce a string of length 1)" msgstr "" -#: ../../library/stdtypes.rst:2517 +#: ../../library/stdtypes.rst:2518 msgid "" "The representation of bytes objects uses the literal format (``b'...'``) " "since it is often more useful than e.g. ``bytes([46, 46, 46])``. You can " "always convert a bytes object into a list of integers using ``list(b)``." msgstr "" -#: ../../library/stdtypes.rst:2522 +#: ../../library/stdtypes.rst:2523 msgid "" "For Python 2.x users: In the Python 2.x series, a variety of implicit " "conversions between 8-bit strings (the closest thing 2.x offers to a built-" @@ -3220,51 +3220,51 @@ msgid "" "objects will always compare unequal." msgstr "" -#: ../../library/stdtypes.rst:2535 +#: ../../library/stdtypes.rst:2536 msgid "Bytearray Objects" msgstr "" -#: ../../library/stdtypes.rst:2539 +#: ../../library/stdtypes.rst:2540 msgid "" ":class:`bytearray` objects are a mutable counterpart to :class:`bytes` " "objects." msgstr "" -#: ../../library/stdtypes.rst:2544 +#: ../../library/stdtypes.rst:2545 msgid "" "There is no dedicated literal syntax for bytearray objects, instead they are " "always created by calling the constructor:" msgstr "" -#: ../../library/stdtypes.rst:2547 +#: ../../library/stdtypes.rst:2548 msgid "Creating an empty instance: ``bytearray()``" msgstr "" -#: ../../library/stdtypes.rst:2548 +#: ../../library/stdtypes.rst:2549 msgid "Creating a zero-filled instance with a given length: ``bytearray(10)``" msgstr "" -#: ../../library/stdtypes.rst:2549 +#: ../../library/stdtypes.rst:2550 msgid "From an iterable of integers: ``bytearray(range(20))``" msgstr "" -#: ../../library/stdtypes.rst:2550 +#: ../../library/stdtypes.rst:2551 msgid "" "Copying existing binary data via the buffer protocol: ``bytearray(b'Hi!')``" msgstr "" -#: ../../library/stdtypes.rst:2552 +#: ../../library/stdtypes.rst:2553 msgid "" "As bytearray objects are mutable, they support the :ref:`mutable ` sequence operations in addition to the common bytes and bytearray " "operations described in :ref:`bytes-methods`." msgstr "" -#: ../../library/stdtypes.rst:2556 +#: ../../library/stdtypes.rst:2557 msgid "Also see the :ref:`bytearray ` built-in." msgstr "" -#: ../../library/stdtypes.rst:2558 +#: ../../library/stdtypes.rst:2559 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -3272,33 +3272,33 @@ msgid "" "in that format:" msgstr "" -#: ../../library/stdtypes.rst:2564 +#: ../../library/stdtypes.rst:2565 msgid "" "This :class:`bytearray` class method returns bytearray object, decoding the " "given string object. The string must contain two hexadecimal digits per " "byte, with ASCII whitespace being ignored." msgstr "" -#: ../../library/stdtypes.rst:2571 +#: ../../library/stdtypes.rst:2572 msgid "" ":meth:`bytearray.fromhex` now skips all ASCII whitespace in the string, not " "just spaces." msgstr "" -#: ../../library/stdtypes.rst:2575 +#: ../../library/stdtypes.rst:2576 msgid "" "A reverse conversion function exists to transform a bytearray object into " "its hexadecimal representation." msgstr "" -#: ../../library/stdtypes.rst:2588 +#: ../../library/stdtypes.rst:2589 msgid "" "Similar to :meth:`bytes.hex`, :meth:`bytearray.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: ../../library/stdtypes.rst:2593 +#: ../../library/stdtypes.rst:2594 msgid "" "Since bytearray objects are sequences of integers (akin to a list), for a " "bytearray object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be " @@ -3306,7 +3306,7 @@ msgid "" "both indexing and slicing will produce a string of length 1)" msgstr "" -#: ../../library/stdtypes.rst:2598 +#: ../../library/stdtypes.rst:2599 msgid "" "The representation of bytearray objects uses the bytes literal format " "(``bytearray(b'...')``) since it is often more useful than e.g. " @@ -3314,11 +3314,11 @@ msgid "" "a list of integers using ``list(b)``." msgstr "" -#: ../../library/stdtypes.rst:2607 +#: ../../library/stdtypes.rst:2608 msgid "Bytes and Bytearray Operations" msgstr "" -#: ../../library/stdtypes.rst:2612 +#: ../../library/stdtypes.rst:2613 msgid "" "Both bytes and bytearray objects support the :ref:`common ` " "sequence operations. They interoperate not just with operands of the same " @@ -3327,97 +3327,97 @@ msgid "" "return type of the result may depend on the order of operands." msgstr "" -#: ../../library/stdtypes.rst:2620 +#: ../../library/stdtypes.rst:2621 msgid "" "The methods on bytes and bytearray objects don't accept strings as their " "arguments, just as the methods on strings don't accept bytes as their " "arguments. For example, you have to write::" msgstr "" -#: ../../library/stdtypes.rst:2627 +#: ../../library/stdtypes.rst:2628 msgid "and::" msgstr "" "和：\n" "\n" "::" -#: ../../library/stdtypes.rst:2632 +#: ../../library/stdtypes.rst:2633 msgid "" "Some bytes and bytearray operations assume the use of ASCII compatible " "binary formats, and hence should be avoided when working with arbitrary " "binary data. These restrictions are covered below." msgstr "" -#: ../../library/stdtypes.rst:2637 +#: ../../library/stdtypes.rst:2638 msgid "" "Using these ASCII based operations to manipulate binary data that is not " "stored in an ASCII based format may lead to data corruption." msgstr "" -#: ../../library/stdtypes.rst:2640 +#: ../../library/stdtypes.rst:2641 msgid "" "The following methods on bytes and bytearray objects can be used with " "arbitrary binary data." msgstr "" -#: ../../library/stdtypes.rst:2646 +#: ../../library/stdtypes.rst:2647 msgid "" "Return the number of non-overlapping occurrences of subsequence *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" -#: ../../library/stdtypes.rst:2650 ../../library/stdtypes.rst:2749 -#: ../../library/stdtypes.rst:2771 ../../library/stdtypes.rst:2837 -#: ../../library/stdtypes.rst:2850 +#: ../../library/stdtypes.rst:2651 ../../library/stdtypes.rst:2750 +#: ../../library/stdtypes.rst:2772 ../../library/stdtypes.rst:2838 +#: ../../library/stdtypes.rst:2851 msgid "" "The subsequence to search for may be any :term:`bytes-like object` or an " "integer in the range 0 to 255." msgstr "" -#: ../../library/stdtypes.rst:2653 ../../library/stdtypes.rst:2761 -#: ../../library/stdtypes.rst:2774 ../../library/stdtypes.rst:2840 -#: ../../library/stdtypes.rst:2853 +#: ../../library/stdtypes.rst:2654 ../../library/stdtypes.rst:2762 +#: ../../library/stdtypes.rst:2775 ../../library/stdtypes.rst:2841 +#: ../../library/stdtypes.rst:2854 msgid "Also accept an integer in the range 0 to 255 as the subsequence." msgstr "" -#: ../../library/stdtypes.rst:2660 +#: ../../library/stdtypes.rst:2661 msgid "" "If the binary data starts with the *prefix* string, return " "``bytes[len(prefix):]``. Otherwise, return a copy of the original binary " "data::" msgstr "" -#: ../../library/stdtypes.rst:2669 +#: ../../library/stdtypes.rst:2670 msgid "The *prefix* may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2673 ../../library/stdtypes.rst:2695 -#: ../../library/stdtypes.rst:2825 ../../library/stdtypes.rst:2918 -#: ../../library/stdtypes.rst:2932 ../../library/stdtypes.rst:2963 -#: ../../library/stdtypes.rst:2977 ../../library/stdtypes.rst:3019 -#: ../../library/stdtypes.rst:3089 ../../library/stdtypes.rst:3107 -#: ../../library/stdtypes.rst:3135 ../../library/stdtypes.rst:3274 -#: ../../library/stdtypes.rst:3329 ../../library/stdtypes.rst:3372 -#: ../../library/stdtypes.rst:3393 ../../library/stdtypes.rst:3415 -#: ../../library/stdtypes.rst:3617 +#: ../../library/stdtypes.rst:2674 ../../library/stdtypes.rst:2696 +#: ../../library/stdtypes.rst:2826 ../../library/stdtypes.rst:2919 +#: ../../library/stdtypes.rst:2933 ../../library/stdtypes.rst:2964 +#: ../../library/stdtypes.rst:2978 ../../library/stdtypes.rst:3020 +#: ../../library/stdtypes.rst:3090 ../../library/stdtypes.rst:3108 +#: ../../library/stdtypes.rst:3136 ../../library/stdtypes.rst:3275 +#: ../../library/stdtypes.rst:3330 ../../library/stdtypes.rst:3373 +#: ../../library/stdtypes.rst:3394 ../../library/stdtypes.rst:3416 +#: ../../library/stdtypes.rst:3618 msgid "" "The bytearray version of this method does *not* operate in place - it always " "produces a new object, even if no changes were made." msgstr "" -#: ../../library/stdtypes.rst:2682 +#: ../../library/stdtypes.rst:2683 msgid "" "If the binary data ends with the *suffix* string and that *suffix* is not " "empty, return ``bytes[:-len(suffix)]``. Otherwise, return a copy of the " "original binary data::" msgstr "" -#: ../../library/stdtypes.rst:2691 +#: ../../library/stdtypes.rst:2692 msgid "The *suffix* may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2704 +#: ../../library/stdtypes.rst:2705 msgid "" "Return a string decoded from the given bytes. Default encoding is " "``'utf-8'``. *errors* may be given to set a different error handling " @@ -3428,25 +3428,25 @@ msgid "" "encodings, see section :ref:`standard-encodings`." msgstr "" -#: ../../library/stdtypes.rst:2712 +#: ../../library/stdtypes.rst:2713 msgid "" "By default, the *errors* argument is not checked for best performances, but " "only used at the first decoding error. Enable the :ref:`Python Development " "Mode `, or use a :ref:`debug build ` to check *errors*." msgstr "" -#: ../../library/stdtypes.rst:2718 +#: ../../library/stdtypes.rst:2719 msgid "" "Passing the *encoding* argument to :class:`str` allows decoding any :term:" "`bytes-like object` directly, without needing to make a temporary bytes or " "bytearray object." msgstr "" -#: ../../library/stdtypes.rst:2722 +#: ../../library/stdtypes.rst:2723 msgid "Added support for keyword arguments." msgstr "" -#: ../../library/stdtypes.rst:2733 +#: ../../library/stdtypes.rst:2734 msgid "" "Return ``True`` if the binary data ends with the specified *suffix*, " "otherwise return ``False``. *suffix* can also be a tuple of suffixes to " @@ -3454,11 +3454,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: ../../library/stdtypes.rst:2738 +#: ../../library/stdtypes.rst:2739 msgid "The suffix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2744 +#: ../../library/stdtypes.rst:2745 msgid "" "Return the lowest index in the data where the subsequence *sub* is found, " "such that *sub* is contained in the slice ``s[start:end]``. Optional " @@ -3466,20 +3466,20 @@ msgid "" "``-1`` if *sub* is not found." msgstr "" -#: ../../library/stdtypes.rst:2754 +#: ../../library/stdtypes.rst:2755 msgid "" "The :meth:`~bytes.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" -#: ../../library/stdtypes.rst:2768 +#: ../../library/stdtypes.rst:2769 msgid "" "Like :meth:`~bytes.find`, but raise :exc:`ValueError` when the subsequence " "is not found." msgstr "" -#: ../../library/stdtypes.rst:2781 +#: ../../library/stdtypes.rst:2782 msgid "" "Return a bytes or bytearray object which is the concatenation of the binary " "data sequences in *iterable*. A :exc:`TypeError` will be raised if there " @@ -3489,7 +3489,7 @@ msgid "" "method." msgstr "" -#: ../../library/stdtypes.rst:2792 +#: ../../library/stdtypes.rst:2793 msgid "" "This static method returns a translation table usable for :meth:`bytes." "translate` that will map each character in *from* into the character at the " @@ -3497,7 +3497,7 @@ msgid "" "objects ` and have the same length." msgstr "" -#: ../../library/stdtypes.rst:2803 +#: ../../library/stdtypes.rst:2804 msgid "" "Split the sequence at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -3506,24 +3506,24 @@ msgid "" "by two empty bytes or bytearray objects." msgstr "" -#: ../../library/stdtypes.rst:2810 ../../library/stdtypes.rst:2867 +#: ../../library/stdtypes.rst:2811 ../../library/stdtypes.rst:2868 msgid "The separator to search for may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2816 +#: ../../library/stdtypes.rst:2817 msgid "" "Return a copy of the sequence with all occurrences of subsequence *old* " "replaced by *new*. If the optional argument *count* is given, only the " "first *count* occurrences are replaced." msgstr "" -#: ../../library/stdtypes.rst:2820 +#: ../../library/stdtypes.rst:2821 msgid "" "The subsequence to search for and its replacement may be any :term:`bytes-" "like object`." msgstr "" -#: ../../library/stdtypes.rst:2832 +#: ../../library/stdtypes.rst:2833 msgid "" "Return the highest index in the sequence where the subsequence *sub* is " "found, such that *sub* is contained within ``s[start:end]``. Optional " @@ -3531,13 +3531,13 @@ msgid "" "``-1`` on failure." msgstr "" -#: ../../library/stdtypes.rst:2847 +#: ../../library/stdtypes.rst:2848 msgid "" "Like :meth:`~bytes.rfind` but raises :exc:`ValueError` when the subsequence " "*sub* is not found." msgstr "" -#: ../../library/stdtypes.rst:2860 +#: ../../library/stdtypes.rst:2861 msgid "" "Split the sequence at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -3546,7 +3546,7 @@ msgid "" "followed by a copy of the original sequence." msgstr "" -#: ../../library/stdtypes.rst:2873 +#: ../../library/stdtypes.rst:2874 msgid "" "Return ``True`` if the binary data starts with the specified *prefix*, " "otherwise return ``False``. *prefix* can also be a tuple of prefixes to " @@ -3554,11 +3554,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: ../../library/stdtypes.rst:2878 +#: ../../library/stdtypes.rst:2879 msgid "The prefix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:2884 +#: ../../library/stdtypes.rst:2885 msgid "" "Return a copy of the bytes or bytearray object where all bytes occurring in " "the optional argument *delete* are removed, and the remaining bytes have " @@ -3566,22 +3566,22 @@ msgid "" "object of length 256." msgstr "" -#: ../../library/stdtypes.rst:2889 +#: ../../library/stdtypes.rst:2890 msgid "" "You can use the :func:`bytes.maketrans` method to create a translation table." msgstr "" -#: ../../library/stdtypes.rst:2892 +#: ../../library/stdtypes.rst:2893 msgid "" "Set the *table* argument to ``None`` for translations that only delete " "characters::" msgstr "" -#: ../../library/stdtypes.rst:2898 +#: ../../library/stdtypes.rst:2899 msgid "*delete* is now supported as a keyword argument." msgstr "" -#: ../../library/stdtypes.rst:2902 +#: ../../library/stdtypes.rst:2903 msgid "" "The following methods on bytes and bytearray objects have default behaviours " "that assume the use of ASCII compatible binary formats, but can still be " @@ -3590,7 +3590,7 @@ msgid "" "instead produce new objects." msgstr "" -#: ../../library/stdtypes.rst:2911 +#: ../../library/stdtypes.rst:2912 msgid "" "Return a copy of the object centered in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -3598,7 +3598,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:2925 +#: ../../library/stdtypes.rst:2926 msgid "" "Return a copy of the object left justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -3606,7 +3606,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:2939 +#: ../../library/stdtypes.rst:2940 msgid "" "Return a copy of the sequence with specified leading bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -3616,14 +3616,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:2951 +#: ../../library/stdtypes.rst:2952 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removeprefix` for a method that will remove a " "single prefix string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:2970 +#: ../../library/stdtypes.rst:2971 msgid "" "Return a copy of the object right justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -3631,7 +3631,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: ../../library/stdtypes.rst:2984 +#: ../../library/stdtypes.rst:2985 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " @@ -3641,7 +3641,7 @@ msgid "" "described in detail below." msgstr "" -#: ../../library/stdtypes.rst:2995 +#: ../../library/stdtypes.rst:2996 msgid "" "Return a copy of the sequence with specified trailing bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -3651,14 +3651,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:3007 +#: ../../library/stdtypes.rst:3008 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removesuffix` for a method that will remove a " "single suffix string rather than all of a set of characters. For example::" msgstr "" -#: ../../library/stdtypes.rst:3026 +#: ../../library/stdtypes.rst:3027 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given and non-negative, at most " @@ -3667,7 +3667,7 @@ msgid "" "limit on the number of splits (all possible splits are made)." msgstr "" -#: ../../library/stdtypes.rst:3032 +#: ../../library/stdtypes.rst:3033 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')`` " @@ -3678,7 +3678,7 @@ msgid "" "object being split. The *sep* argument may be any :term:`bytes-like object`." msgstr "" -#: ../../library/stdtypes.rst:3050 +#: ../../library/stdtypes.rst:3051 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive ASCII whitespace are regarded as a single " @@ -3688,7 +3688,7 @@ msgid "" "without a specified separator returns ``[]``." msgstr "" -#: ../../library/stdtypes.rst:3071 +#: ../../library/stdtypes.rst:3072 msgid "" "Return a copy of the sequence with specified leading and trailing bytes " "removed. The *chars* argument is a binary sequence specifying the set of " @@ -3698,13 +3698,13 @@ msgid "" "a prefix or suffix; rather, all combinations of its values are stripped::" msgstr "" -#: ../../library/stdtypes.rst:3084 +#: ../../library/stdtypes.rst:3085 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`." msgstr "" -#: ../../library/stdtypes.rst:3093 +#: ../../library/stdtypes.rst:3094 msgid "" "The following methods on bytes and bytearray objects assume the use of ASCII " "compatible binary formats and should not be applied to arbitrary binary " @@ -3712,14 +3712,14 @@ msgid "" "operate in place, and instead produce new objects." msgstr "" -#: ../../library/stdtypes.rst:3101 +#: ../../library/stdtypes.rst:3102 msgid "" "Return a copy of the sequence with each byte interpreted as an ASCII " "character, and the first byte capitalized and the rest lowercased. Non-ASCII " "byte values are passed through unchanged." msgstr "" -#: ../../library/stdtypes.rst:3114 +#: ../../library/stdtypes.rst:3115 msgid "" "Return a copy of the sequence where all ASCII tab characters are replaced by " "one or more ASCII spaces, depending on the current column and the given tab " @@ -3735,7 +3735,7 @@ msgid "" "by one regardless of how the byte value is represented when printed::" msgstr "" -#: ../../library/stdtypes.rst:3142 +#: ../../library/stdtypes.rst:3143 msgid "" "Return ``True`` if all bytes in the sequence are alphabetical ASCII " "characters or ASCII decimal digits and the sequence is not empty, ``False`` " @@ -3744,7 +3744,7 @@ msgid "" "digits are those byte values in the sequence ``b'0123456789'``." msgstr "" -#: ../../library/stdtypes.rst:3159 +#: ../../library/stdtypes.rst:3160 msgid "" "Return ``True`` if all bytes in the sequence are alphabetic ASCII characters " "and the sequence is not empty, ``False`` otherwise. Alphabetic ASCII " @@ -3752,35 +3752,35 @@ msgid "" "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: ../../library/stdtypes.rst:3175 +#: ../../library/stdtypes.rst:3176 msgid "" "Return ``True`` if the sequence is empty or all bytes in the sequence are " "ASCII, ``False`` otherwise. ASCII bytes are in the range 0-0x7F." msgstr "" -#: ../../library/stdtypes.rst:3185 +#: ../../library/stdtypes.rst:3186 msgid "" "Return ``True`` if all bytes in the sequence are ASCII decimal digits and " "the sequence is not empty, ``False`` otherwise. ASCII decimal digits are " "those byte values in the sequence ``b'0123456789'``." msgstr "" -#: ../../library/stdtypes.rst:3200 +#: ../../library/stdtypes.rst:3201 msgid "" "Return ``True`` if there is at least one lowercase ASCII character in the " "sequence and no uppercase ASCII characters, ``False`` otherwise." msgstr "" -#: ../../library/stdtypes.rst:3210 ../../library/stdtypes.rst:3252 -#: ../../library/stdtypes.rst:3268 ../../library/stdtypes.rst:3318 -#: ../../library/stdtypes.rst:3387 +#: ../../library/stdtypes.rst:3211 ../../library/stdtypes.rst:3253 +#: ../../library/stdtypes.rst:3269 ../../library/stdtypes.rst:3319 +#: ../../library/stdtypes.rst:3388 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " "values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: ../../library/stdtypes.rst:3218 +#: ../../library/stdtypes.rst:3219 msgid "" "Return ``True`` if all bytes in the sequence are ASCII whitespace and the " "sequence is not empty, ``False`` otherwise. ASCII whitespace characters are " @@ -3788,27 +3788,27 @@ msgid "" "newline, carriage return, vertical tab, form feed)." msgstr "" -#: ../../library/stdtypes.rst:3227 +#: ../../library/stdtypes.rst:3228 msgid "" "Return ``True`` if the sequence is ASCII titlecase and the sequence is not " "empty, ``False`` otherwise. See :meth:`bytes.title` for more details on the " "definition of \"titlecase\"." msgstr "" -#: ../../library/stdtypes.rst:3242 +#: ../../library/stdtypes.rst:3243 msgid "" "Return ``True`` if there is at least one uppercase alphabetic ASCII " "character in the sequence and no lowercase ASCII characters, ``False`` " "otherwise." msgstr "" -#: ../../library/stdtypes.rst:3260 +#: ../../library/stdtypes.rst:3261 msgid "" "Return a copy of the sequence with all the uppercase ASCII characters " "converted to their corresponding lowercase counterpart." msgstr "" -#: ../../library/stdtypes.rst:3285 +#: ../../library/stdtypes.rst:3286 msgid "" "Return a list of the lines in the binary sequence, breaking at ASCII line " "boundaries. This method uses the :term:`universal newlines` approach to " @@ -3816,20 +3816,20 @@ msgid "" "*keepends* is given and true." msgstr "" -#: ../../library/stdtypes.rst:3297 +#: ../../library/stdtypes.rst:3298 msgid "" "Unlike :meth:`~bytes.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" -#: ../../library/stdtypes.rst:3310 +#: ../../library/stdtypes.rst:3311 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart and vice-versa." msgstr "" -#: ../../library/stdtypes.rst:3322 +#: ../../library/stdtypes.rst:3323 msgid "" "Unlike :func:`str.swapcase()`, it is always the case that ``bin.swapcase()." "swapcase() == bin`` for the binary versions. Case conversions are " @@ -3837,14 +3837,14 @@ msgid "" "Unicode code points." msgstr "" -#: ../../library/stdtypes.rst:3336 +#: ../../library/stdtypes.rst:3337 msgid "" "Return a titlecased version of the binary sequence where words start with an " "uppercase ASCII character and the remaining characters are lowercase. " "Uncased byte values are left unmodified." msgstr "" -#: ../../library/stdtypes.rst:3345 +#: ../../library/stdtypes.rst:3346 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " @@ -3852,13 +3852,13 @@ msgid "" "values are uncased." msgstr "" -#: ../../library/stdtypes.rst:3379 +#: ../../library/stdtypes.rst:3380 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart." msgstr "" -#: ../../library/stdtypes.rst:3400 +#: ../../library/stdtypes.rst:3401 msgid "" "Return a copy of the sequence left filled with ASCII ``b'0'`` digits to make " "a sequence of length *width*. A leading sign prefix (``b'+'``/ ``b'-'``) is " @@ -3867,11 +3867,11 @@ msgid "" "*width* is less than or equal to ``len(seq)``." msgstr "" -#: ../../library/stdtypes.rst:3422 +#: ../../library/stdtypes.rst:3423 msgid "``printf``-style Bytes Formatting" msgstr "" -#: ../../library/stdtypes.rst:3439 +#: ../../library/stdtypes.rst:3440 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -3879,7 +3879,7 @@ msgid "" "dictionary, wrap it in a tuple." msgstr "" -#: ../../library/stdtypes.rst:3444 +#: ../../library/stdtypes.rst:3445 msgid "" "Bytes objects (``bytes``/``bytearray``) have one unique built-in operation: " "the ``%`` operator (modulo). This is also known as the bytes *formatting* or " @@ -3889,7 +3889,7 @@ msgid "" "func:`sprintf` in the C language." msgstr "" -#: ../../library/stdtypes.rst:3451 +#: ../../library/stdtypes.rst:3452 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -3897,7 +3897,7 @@ msgid "" "example, a dictionary)." msgstr "" -#: ../../library/stdtypes.rst:3485 +#: ../../library/stdtypes.rst:3486 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the bytes object *must* include a parenthesised mapping key into " @@ -3905,73 +3905,73 @@ msgid "" "mapping key selects the value to be formatted from the mapping. For example:" msgstr "" -#: ../../library/stdtypes.rst:3559 +#: ../../library/stdtypes.rst:3560 msgid "Single byte (accepts integer or single byte objects)." msgstr "" -#: ../../library/stdtypes.rst:3562 +#: ../../library/stdtypes.rst:3563 msgid "``'b'``" msgstr "``'b'``" -#: ../../library/stdtypes.rst:3562 +#: ../../library/stdtypes.rst:3563 msgid "" "Bytes (any object that follows the :ref:`buffer protocol ` or " "has :meth:`__bytes__`)." msgstr "" -#: ../../library/stdtypes.rst:3566 +#: ../../library/stdtypes.rst:3567 msgid "" "``'s'`` is an alias for ``'b'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: ../../library/stdtypes.rst:3569 +#: ../../library/stdtypes.rst:3570 msgid "" "Bytes (converts any Python object using ``repr(obj)." "encode('ascii','backslashreplace)``)." msgstr "" -#: ../../library/stdtypes.rst:3572 +#: ../../library/stdtypes.rst:3573 msgid "" "``'r'`` is an alias for ``'a'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: ../../library/stdtypes.rst:3572 +#: ../../library/stdtypes.rst:3573 msgid "\\(7)" msgstr "\\(7)" -#: ../../library/stdtypes.rst:3607 +#: ../../library/stdtypes.rst:3608 msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: ../../library/stdtypes.rst:3610 +#: ../../library/stdtypes.rst:3611 msgid "``b'%r'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: ../../library/stdtypes.rst:3622 +#: ../../library/stdtypes.rst:3623 msgid ":pep:`461` - Adding % formatting to bytes and bytearray" msgstr "" -#: ../../library/stdtypes.rst:3629 +#: ../../library/stdtypes.rst:3630 msgid "Memory Views" msgstr "" -#: ../../library/stdtypes.rst:3631 +#: ../../library/stdtypes.rst:3632 msgid "" ":class:`memoryview` objects allow Python code to access the internal data of " "an object that supports the :ref:`buffer protocol ` without " "copying." msgstr "" -#: ../../library/stdtypes.rst:3637 +#: ../../library/stdtypes.rst:3638 msgid "" "Create a :class:`memoryview` that references *object*. *object* must " "support the buffer protocol. Built-in objects that support the buffer " "protocol include :class:`bytes` and :class:`bytearray`." msgstr "" -#: ../../library/stdtypes.rst:3641 +#: ../../library/stdtypes.rst:3642 msgid "" "A :class:`memoryview` has the notion of an *element*, which is the atomic " "memory unit handled by the originating *object*. For many simple types such " @@ -3979,7 +3979,7 @@ msgid "" "other types such as :class:`array.array` may have bigger elements." msgstr "" -#: ../../library/stdtypes.rst:3646 +#: ../../library/stdtypes.rst:3647 msgid "" "``len(view)`` is equal to the length of :class:`~memoryview.tolist`. If " "``view.ndim = 0``, the length is 1. If ``view.ndim = 1``, the length is " @@ -3989,13 +3989,13 @@ msgid "" "bytes in a single element." msgstr "" -#: ../../library/stdtypes.rst:3653 +#: ../../library/stdtypes.rst:3654 msgid "" "A :class:`memoryview` supports slicing and indexing to expose its data. One-" "dimensional slicing will result in a subview::" msgstr "" -#: ../../library/stdtypes.rst:3666 +#: ../../library/stdtypes.rst:3667 msgid "" "If :class:`~memoryview.format` is one of the native format specifiers from " "the :mod:`struct` module, indexing with an integer or a tuple of integers is " @@ -4006,82 +4006,82 @@ msgid "" "memoryviews can be indexed with the empty tuple." msgstr "" -#: ../../library/stdtypes.rst:3675 +#: ../../library/stdtypes.rst:3676 msgid "Here is an example with a non-byte format::" msgstr "" -#: ../../library/stdtypes.rst:3687 +#: ../../library/stdtypes.rst:3688 msgid "" "If the underlying object is writable, the memoryview supports one-" "dimensional slice assignment. Resizing is not allowed::" msgstr "" -#: ../../library/stdtypes.rst:3708 +#: ../../library/stdtypes.rst:3709 msgid "" "One-dimensional memoryviews of hashable (read-only) types with formats 'B', " "'b' or 'c' are also hashable. The hash is defined as ``hash(m) == hash(m." "tobytes())``::" msgstr "" -#: ../../library/stdtypes.rst:3720 +#: ../../library/stdtypes.rst:3721 msgid "" "One-dimensional memoryviews can now be sliced. One-dimensional memoryviews " "with formats 'B', 'b' or 'c' are now hashable." msgstr "" -#: ../../library/stdtypes.rst:3724 +#: ../../library/stdtypes.rst:3725 msgid "" "memoryview is now registered automatically with :class:`collections.abc." "Sequence`" msgstr "" -#: ../../library/stdtypes.rst:3728 +#: ../../library/stdtypes.rst:3729 msgid "memoryviews can now be indexed with tuple of integers." msgstr "" -#: ../../library/stdtypes.rst:3731 +#: ../../library/stdtypes.rst:3732 msgid ":class:`memoryview` has several methods:" msgstr "" -#: ../../library/stdtypes.rst:3735 +#: ../../library/stdtypes.rst:3736 msgid "" "A memoryview and a :pep:`3118` exporter are equal if their shapes are " "equivalent and if all corresponding values are equal when the operands' " "respective format codes are interpreted using :mod:`struct` syntax." msgstr "" -#: ../../library/stdtypes.rst:3739 +#: ../../library/stdtypes.rst:3740 msgid "" "For the subset of :mod:`struct` format strings currently supported by :meth:" "`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == w.tolist()``::" msgstr "" -#: ../../library/stdtypes.rst:3758 +#: ../../library/stdtypes.rst:3759 msgid "" "If either format string is not supported by the :mod:`struct` module, then " "the objects will always compare as unequal (even if the format strings and " "buffer contents are identical)::" msgstr "" -#: ../../library/stdtypes.rst:3774 +#: ../../library/stdtypes.rst:3775 msgid "" "Note that, as with floating point numbers, ``v is w`` does *not* imply ``v " "== w`` for memoryview objects." msgstr "" -#: ../../library/stdtypes.rst:3777 +#: ../../library/stdtypes.rst:3778 msgid "" "Previous versions compared the raw memory disregarding the item format and " "the logical array structure." msgstr "" -#: ../../library/stdtypes.rst:3783 +#: ../../library/stdtypes.rst:3784 msgid "" "Return the data in the buffer as a bytestring. This is equivalent to " "calling the :class:`bytes` constructor on the memoryview. ::" msgstr "" -#: ../../library/stdtypes.rst:3792 +#: ../../library/stdtypes.rst:3793 msgid "" "For non-contiguous arrays the result is equal to the flattened list " "representation with all elements converted to bytes. :meth:`tobytes` " @@ -4089,7 +4089,7 @@ msgid "" "module syntax." msgstr "" -#: ../../library/stdtypes.rst:3797 +#: ../../library/stdtypes.rst:3798 msgid "" "*order* can be {'C', 'F', 'A'}. When *order* is 'C' or 'F', the data of the " "original array is converted to C or Fortran order. For contiguous views, 'A' " @@ -4098,36 +4098,36 @@ msgid "" "to C first. *order=None* is the same as *order='C'*." msgstr "" -#: ../../library/stdtypes.rst:3806 +#: ../../library/stdtypes.rst:3807 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the buffer. ::" msgstr "" -#: ../../library/stdtypes.rst:3815 +#: ../../library/stdtypes.rst:3816 msgid "" "Similar to :meth:`bytes.hex`, :meth:`memoryview.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: ../../library/stdtypes.rst:3822 +#: ../../library/stdtypes.rst:3823 msgid "Return the data in the buffer as a list of elements. ::" msgstr "" -#: ../../library/stdtypes.rst:3832 +#: ../../library/stdtypes.rst:3833 msgid "" ":meth:`tolist` now supports all single character native formats in :mod:" "`struct` module syntax as well as multi-dimensional representations." msgstr "" -#: ../../library/stdtypes.rst:3839 +#: ../../library/stdtypes.rst:3840 msgid "" "Return a readonly version of the memoryview object. The original memoryview " "object is unchanged. ::" msgstr "" -#: ../../library/stdtypes.rst:3858 +#: ../../library/stdtypes.rst:3859 msgid "" "Release the underlying buffer exposed by the memoryview object. Many " "objects take special actions when a view is held on them (for example, a :" @@ -4136,20 +4136,20 @@ msgid "" "resources) as soon as possible." msgstr "" -#: ../../library/stdtypes.rst:3864 +#: ../../library/stdtypes.rst:3865 msgid "" "After this method has been called, any further operation on the view raises " "a :class:`ValueError` (except :meth:`release()` itself which can be called " "multiple times)::" msgstr "" -#: ../../library/stdtypes.rst:3875 +#: ../../library/stdtypes.rst:3876 msgid "" "The context management protocol can be used for a similar effect, using the " "``with`` statement::" msgstr "" -#: ../../library/stdtypes.rst:3891 +#: ../../library/stdtypes.rst:3892 msgid "" "Cast a memoryview to a new format or shape. *shape* defaults to " "``[byte_length//new_itemsize]``, which means that the result view will be " @@ -4158,57 +4158,57 @@ msgid "" "contiguous -> 1D." msgstr "" -#: ../../library/stdtypes.rst:3897 +#: ../../library/stdtypes.rst:3898 msgid "" "The destination format is restricted to a single element native format in :" "mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' or " "'c'). The byte length of the result must be the same as the original length." msgstr "" -#: ../../library/stdtypes.rst:3902 +#: ../../library/stdtypes.rst:3903 msgid "Cast 1D/long to 1D/unsigned bytes::" msgstr "" -#: ../../library/stdtypes.rst:3925 +#: ../../library/stdtypes.rst:3926 msgid "Cast 1D/unsigned bytes to 1D/char::" msgstr "" -#: ../../library/stdtypes.rst:3938 +#: ../../library/stdtypes.rst:3939 msgid "Cast 1D/bytes to 3D/ints to 1D/signed char::" msgstr "" -#: ../../library/stdtypes.rst:3964 +#: ../../library/stdtypes.rst:3965 msgid "Cast 1D/unsigned long to 2D/unsigned long::" msgstr "" -#: ../../library/stdtypes.rst:3978 +#: ../../library/stdtypes.rst:3979 msgid "The source format is no longer restricted when casting to a byte view." msgstr "" -#: ../../library/stdtypes.rst:3981 +#: ../../library/stdtypes.rst:3982 msgid "There are also several readonly attributes available:" msgstr "" -#: ../../library/stdtypes.rst:3985 +#: ../../library/stdtypes.rst:3986 msgid "The underlying object of the memoryview::" msgstr "" -#: ../../library/stdtypes.rst:3996 +#: ../../library/stdtypes.rst:3997 msgid "" "``nbytes == product(shape) * itemsize == len(m.tobytes())``. This is the " "amount of space in bytes that the array would use in a contiguous " "representation. It is not necessarily equal to ``len(m)``::" msgstr "" -#: ../../library/stdtypes.rst:4015 +#: ../../library/stdtypes.rst:4016 msgid "Multi-dimensional arrays::" msgstr "" -#: ../../library/stdtypes.rst:4032 +#: ../../library/stdtypes.rst:4033 msgid "A bool indicating whether the memory is read only." msgstr "" -#: ../../library/stdtypes.rst:4036 +#: ../../library/stdtypes.rst:4037 msgid "" "A string containing the format (in :mod:`struct` module style) for each " "element in the view. A memoryview can be created from exporters with " @@ -4216,59 +4216,59 @@ msgid "" "restricted to native single element formats." msgstr "" -#: ../../library/stdtypes.rst:4041 +#: ../../library/stdtypes.rst:4042 msgid "" "format ``'B'`` is now handled according to the struct module syntax. This " "means that ``memoryview(b'abc')[0] == b'abc'[0] == 97``." msgstr "" -#: ../../library/stdtypes.rst:4047 +#: ../../library/stdtypes.rst:4048 msgid "The size in bytes of each element of the memoryview::" msgstr "" -#: ../../library/stdtypes.rst:4060 +#: ../../library/stdtypes.rst:4061 msgid "" "An integer indicating how many dimensions of a multi-dimensional array the " "memory represents." msgstr "" -#: ../../library/stdtypes.rst:4065 +#: ../../library/stdtypes.rst:4066 msgid "" "A tuple of integers the length of :attr:`ndim` giving the shape of the " "memory as an N-dimensional array." msgstr "" -#: ../../library/stdtypes.rst:4068 ../../library/stdtypes.rst:4076 +#: ../../library/stdtypes.rst:4069 ../../library/stdtypes.rst:4077 msgid "An empty tuple instead of ``None`` when ndim = 0." msgstr "" -#: ../../library/stdtypes.rst:4073 +#: ../../library/stdtypes.rst:4074 msgid "" "A tuple of integers the length of :attr:`ndim` giving the size in bytes to " "access each element for each dimension of the array." msgstr "" -#: ../../library/stdtypes.rst:4081 +#: ../../library/stdtypes.rst:4082 msgid "Used internally for PIL-style arrays. The value is informational only." msgstr "" -#: ../../library/stdtypes.rst:4085 +#: ../../library/stdtypes.rst:4086 msgid "A bool indicating whether the memory is C-:term:`contiguous`." msgstr "" -#: ../../library/stdtypes.rst:4091 +#: ../../library/stdtypes.rst:4092 msgid "A bool indicating whether the memory is Fortran :term:`contiguous`." msgstr "" -#: ../../library/stdtypes.rst:4097 +#: ../../library/stdtypes.rst:4098 msgid "A bool indicating whether the memory is :term:`contiguous`." msgstr "" -#: ../../library/stdtypes.rst:4105 +#: ../../library/stdtypes.rst:4106 msgid "Set Types --- :class:`set`, :class:`frozenset`" msgstr "" -#: ../../library/stdtypes.rst:4109 +#: ../../library/stdtypes.rst:4110 msgid "" "A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " "objects. Common uses include membership testing, removing duplicates from a " @@ -4278,7 +4278,7 @@ msgid "" "`collections` module.)" msgstr "" -#: ../../library/stdtypes.rst:4116 +#: ../../library/stdtypes.rst:4117 msgid "" "Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " "in set``. Being an unordered collection, sets do not record element " @@ -4286,7 +4286,7 @@ msgid "" "slicing, or other sequence-like behavior." msgstr "" -#: ../../library/stdtypes.rst:4121 +#: ../../library/stdtypes.rst:4122 msgid "" "There are currently two built-in set types, :class:`set` and :class:" "`frozenset`. The :class:`set` type is mutable --- the contents can be " @@ -4298,18 +4298,18 @@ msgid "" "of another set." msgstr "" -#: ../../library/stdtypes.rst:4129 +#: ../../library/stdtypes.rst:4130 msgid "" "Non-empty sets (not frozensets) can be created by placing a comma-separated " "list of elements within braces, for example: ``{'jack', 'sjoerd'}``, in " "addition to the :class:`set` constructor." msgstr "" -#: ../../library/stdtypes.rst:4133 +#: ../../library/stdtypes.rst:4134 msgid "The constructors for both classes work the same:" msgstr "" -#: ../../library/stdtypes.rst:4138 +#: ../../library/stdtypes.rst:4139 msgid "" "Return a new set or frozenset object whose elements are taken from " "*iterable*. The elements of a set must be :term:`hashable`. To represent " @@ -4317,92 +4317,92 @@ msgid "" "*iterable* is not specified, a new empty set is returned." msgstr "" -#: ../../library/stdtypes.rst:4144 +#: ../../library/stdtypes.rst:4145 msgid "Sets can be created by several means:" msgstr "" -#: ../../library/stdtypes.rst:4146 +#: ../../library/stdtypes.rst:4147 msgid "" "Use a comma-separated list of elements within braces: ``{'jack', 'sjoerd'}``" msgstr "" -#: ../../library/stdtypes.rst:4147 +#: ../../library/stdtypes.rst:4148 msgid "" "Use a set comprehension: ``{c for c in 'abracadabra' if c not in 'abc'}``" msgstr "" -#: ../../library/stdtypes.rst:4148 +#: ../../library/stdtypes.rst:4149 msgid "" "Use the type constructor: ``set()``, ``set('foobar')``, ``set(['a', 'b', " "'foo'])``" msgstr "" -#: ../../library/stdtypes.rst:4150 +#: ../../library/stdtypes.rst:4151 msgid "" "Instances of :class:`set` and :class:`frozenset` provide the following " "operations:" msgstr "" -#: ../../library/stdtypes.rst:4155 +#: ../../library/stdtypes.rst:4156 msgid "Return the number of elements in set *s* (cardinality of *s*)." msgstr "" -#: ../../library/stdtypes.rst:4159 +#: ../../library/stdtypes.rst:4160 msgid "Test *x* for membership in *s*." msgstr "" -#: ../../library/stdtypes.rst:4163 +#: ../../library/stdtypes.rst:4164 msgid "Test *x* for non-membership in *s*." msgstr "" -#: ../../library/stdtypes.rst:4167 +#: ../../library/stdtypes.rst:4168 msgid "" "Return ``True`` if the set has no elements in common with *other*. Sets are " "disjoint if and only if their intersection is the empty set." msgstr "" -#: ../../library/stdtypes.rst:4173 +#: ../../library/stdtypes.rst:4174 msgid "Test whether every element in the set is in *other*." msgstr "" -#: ../../library/stdtypes.rst:4177 +#: ../../library/stdtypes.rst:4178 msgid "" "Test whether the set is a proper subset of *other*, that is, ``set <= other " "and set != other``." msgstr "" -#: ../../library/stdtypes.rst:4183 +#: ../../library/stdtypes.rst:4184 msgid "Test whether every element in *other* is in the set." msgstr "" -#: ../../library/stdtypes.rst:4187 +#: ../../library/stdtypes.rst:4188 msgid "" "Test whether the set is a proper superset of *other*, that is, ``set >= " "other and set != other``." msgstr "" -#: ../../library/stdtypes.rst:4193 +#: ../../library/stdtypes.rst:4194 msgid "Return a new set with elements from the set and all others." msgstr "" -#: ../../library/stdtypes.rst:4198 +#: ../../library/stdtypes.rst:4199 msgid "Return a new set with elements common to the set and all others." msgstr "" -#: ../../library/stdtypes.rst:4203 +#: ../../library/stdtypes.rst:4204 msgid "Return a new set with elements in the set that are not in the others." msgstr "" -#: ../../library/stdtypes.rst:4208 +#: ../../library/stdtypes.rst:4209 msgid "" "Return a new set with elements in either the set or *other* but not both." msgstr "" -#: ../../library/stdtypes.rst:4212 +#: ../../library/stdtypes.rst:4213 msgid "Return a shallow copy of the set." msgstr "" -#: ../../library/stdtypes.rst:4215 +#: ../../library/stdtypes.rst:4216 msgid "" "Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" "meth:`difference`, :meth:`symmetric_difference`, :meth:`issubset`, and :meth:" @@ -4412,7 +4412,7 @@ msgid "" "the more readable ``set('abc').intersection('cbs')``." msgstr "" -#: ../../library/stdtypes.rst:4222 +#: ../../library/stdtypes.rst:4223 msgid "" "Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " "sets are equal if and only if every element of each set is contained in the " @@ -4422,14 +4422,14 @@ msgid "" "set is a proper superset of the second set (is a superset, but is not equal)." msgstr "" -#: ../../library/stdtypes.rst:4229 +#: ../../library/stdtypes.rst:4230 msgid "" "Instances of :class:`set` are compared to instances of :class:`frozenset` " "based on their members. For example, ``set('abc') == frozenset('abc')`` " "returns ``True`` and so does ``set('abc') in set([frozenset('abc')])``." msgstr "" -#: ../../library/stdtypes.rst:4233 +#: ../../library/stdtypes.rst:4234 msgid "" "The subset and equality comparisons do not generalize to a total ordering " "function. For example, any two nonempty disjoint sets are not equal and are " @@ -4437,71 +4437,71 @@ msgid "" "``ab``." msgstr "" -#: ../../library/stdtypes.rst:4238 +#: ../../library/stdtypes.rst:4239 msgid "" "Since sets only define partial ordering (subset relationships), the output " "of the :meth:`list.sort` method is undefined for lists of sets." msgstr "" -#: ../../library/stdtypes.rst:4241 +#: ../../library/stdtypes.rst:4242 msgid "Set elements, like dictionary keys, must be :term:`hashable`." msgstr "" -#: ../../library/stdtypes.rst:4243 +#: ../../library/stdtypes.rst:4244 msgid "" "Binary operations that mix :class:`set` instances with :class:`frozenset` " "return the type of the first operand. For example: ``frozenset('ab') | " "set('bc')`` returns an instance of :class:`frozenset`." msgstr "" -#: ../../library/stdtypes.rst:4247 +#: ../../library/stdtypes.rst:4248 msgid "" "The following table lists operations available for :class:`set` that do not " "apply to immutable instances of :class:`frozenset`:" msgstr "" -#: ../../library/stdtypes.rst:4253 +#: ../../library/stdtypes.rst:4254 msgid "Update the set, adding elements from all others." msgstr "" -#: ../../library/stdtypes.rst:4258 +#: ../../library/stdtypes.rst:4259 msgid "Update the set, keeping only elements found in it and all others." msgstr "" -#: ../../library/stdtypes.rst:4263 +#: ../../library/stdtypes.rst:4264 msgid "Update the set, removing elements found in others." msgstr "" -#: ../../library/stdtypes.rst:4268 +#: ../../library/stdtypes.rst:4269 msgid "" "Update the set, keeping only elements found in either set, but not in both." msgstr "" -#: ../../library/stdtypes.rst:4272 +#: ../../library/stdtypes.rst:4273 msgid "Add element *elem* to the set." msgstr "" -#: ../../library/stdtypes.rst:4276 +#: ../../library/stdtypes.rst:4277 msgid "" "Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " "contained in the set." msgstr "" -#: ../../library/stdtypes.rst:4281 +#: ../../library/stdtypes.rst:4282 msgid "Remove element *elem* from the set if it is present." msgstr "" -#: ../../library/stdtypes.rst:4285 +#: ../../library/stdtypes.rst:4286 msgid "" "Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " "if the set is empty." msgstr "" -#: ../../library/stdtypes.rst:4290 +#: ../../library/stdtypes.rst:4291 msgid "Remove all elements from the set." msgstr "" -#: ../../library/stdtypes.rst:4293 +#: ../../library/stdtypes.rst:4294 msgid "" "Note, the non-operator versions of the :meth:`update`, :meth:" "`intersection_update`, :meth:`difference_update`, and :meth:" @@ -4509,18 +4509,18 @@ msgid "" "argument." msgstr "" -#: ../../library/stdtypes.rst:4298 +#: ../../library/stdtypes.rst:4299 msgid "" "Note, the *elem* argument to the :meth:`__contains__`, :meth:`remove`, and :" "meth:`discard` methods may be a set. To support searching for an equivalent " "frozenset, a temporary one is created from *elem*." msgstr "" -#: ../../library/stdtypes.rst:4306 +#: ../../library/stdtypes.rst:4307 msgid "Mapping Types --- :class:`dict`" msgstr "" -#: ../../library/stdtypes.rst:4316 +#: ../../library/stdtypes.rst:4317 msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " @@ -4529,7 +4529,7 @@ msgid "" "module.)" msgstr "" -#: ../../library/stdtypes.rst:4322 +#: ../../library/stdtypes.rst:4323 msgid "" "A dictionary's keys are *almost* arbitrary values. Values that are not :" "term:`hashable`, that is, values containing lists, dictionaries or other " @@ -4541,40 +4541,40 @@ msgid "" "approximations it is usually unwise to use them as dictionary keys.)" msgstr "" -#: ../../library/stdtypes.rst:4331 +#: ../../library/stdtypes.rst:4332 msgid "" "Dictionaries can be created by placing a comma-separated list of ``key: " "value`` pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` " "or ``{4098: 'jack', 4127: 'sjoerd'}``, or by the :class:`dict` constructor." msgstr "" -#: ../../library/stdtypes.rst:4339 +#: ../../library/stdtypes.rst:4340 msgid "" "Return a new dictionary initialized from an optional positional argument and " "a possibly empty set of keyword arguments." msgstr "" -#: ../../library/stdtypes.rst:4342 +#: ../../library/stdtypes.rst:4343 msgid "Dictionaries can be created by several means:" msgstr "" -#: ../../library/stdtypes.rst:4344 +#: ../../library/stdtypes.rst:4345 msgid "" "Use a comma-separated list of ``key: value`` pairs within braces: ``{'jack': " "4098, 'sjoerd': 4127}`` or ``{4098: 'jack', 4127: 'sjoerd'}``" msgstr "" -#: ../../library/stdtypes.rst:4346 +#: ../../library/stdtypes.rst:4347 msgid "Use a dict comprehension: ``{}``, ``{x: x ** 2 for x in range(10)}``" msgstr "" -#: ../../library/stdtypes.rst:4347 +#: ../../library/stdtypes.rst:4348 msgid "" "Use the type constructor: ``dict()``, ``dict([('foo', 100), ('bar', " "200)])``, ``dict(foo=100, bar=200)``" msgstr "" -#: ../../library/stdtypes.rst:4350 +#: ../../library/stdtypes.rst:4351 msgid "" "If no positional argument is given, an empty dictionary is created. If a " "positional argument is given and it is a mapping object, a dictionary is " @@ -4586,7 +4586,7 @@ msgid "" "value for that key becomes the corresponding value in the new dictionary." msgstr "" -#: ../../library/stdtypes.rst:4360 +#: ../../library/stdtypes.rst:4361 msgid "" "If keyword arguments are given, the keyword arguments and their values are " "added to the dictionary created from the positional argument. If a key " @@ -4594,39 +4594,39 @@ msgid "" "the value from the positional argument." msgstr "" -#: ../../library/stdtypes.rst:4365 +#: ../../library/stdtypes.rst:4366 msgid "" "To illustrate, the following examples all return a dictionary equal to " "``{\"one\": 1, \"two\": 2, \"three\": 3}``::" msgstr "" -#: ../../library/stdtypes.rst:4377 +#: ../../library/stdtypes.rst:4378 msgid "" "Providing keyword arguments as in the first example only works for keys that " "are valid Python identifiers. Otherwise, any valid keys can be used." msgstr "" -#: ../../library/stdtypes.rst:4381 +#: ../../library/stdtypes.rst:4382 msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" msgstr "" -#: ../../library/stdtypes.rst:4386 +#: ../../library/stdtypes.rst:4387 msgid "Return a list of all the keys used in the dictionary *d*." msgstr "" -#: ../../library/stdtypes.rst:4390 +#: ../../library/stdtypes.rst:4391 msgid "Return the number of items in the dictionary *d*." msgstr "" -#: ../../library/stdtypes.rst:4394 +#: ../../library/stdtypes.rst:4395 msgid "" "Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " "not in the map." msgstr "" -#: ../../library/stdtypes.rst:4399 +#: ../../library/stdtypes.rst:4400 msgid "" "If a subclass of dict defines a method :meth:`__missing__` and *key* is not " "present, the ``d[key]`` operation calls that method with the key *key* as " @@ -4637,51 +4637,51 @@ msgid "" "an instance variable::" msgstr "" -#: ../../library/stdtypes.rst:4417 +#: ../../library/stdtypes.rst:4418 msgid "" "The example above shows part of the implementation of :class:`collections." "Counter`. A different ``__missing__`` method is used by :class:`collections." "defaultdict`." msgstr "" -#: ../../library/stdtypes.rst:4423 +#: ../../library/stdtypes.rst:4424 msgid "Set ``d[key]`` to *value*." msgstr "" -#: ../../library/stdtypes.rst:4427 +#: ../../library/stdtypes.rst:4428 msgid "" "Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " "map." msgstr "" -#: ../../library/stdtypes.rst:4432 +#: ../../library/stdtypes.rst:4433 msgid "Return ``True`` if *d* has a key *key*, else ``False``." msgstr "" -#: ../../library/stdtypes.rst:4436 +#: ../../library/stdtypes.rst:4437 msgid "Equivalent to ``not key in d``." msgstr "" -#: ../../library/stdtypes.rst:4440 +#: ../../library/stdtypes.rst:4441 msgid "" "Return an iterator over the keys of the dictionary. This is a shortcut for " "``iter(d.keys())``." msgstr "" -#: ../../library/stdtypes.rst:4445 +#: ../../library/stdtypes.rst:4446 msgid "Remove all items from the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4449 +#: ../../library/stdtypes.rst:4450 msgid "Return a shallow copy of the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4453 +#: ../../library/stdtypes.rst:4454 msgid "" "Create a new dictionary with keys from *iterable* and values set to *value*." msgstr "" -#: ../../library/stdtypes.rst:4455 +#: ../../library/stdtypes.rst:4456 msgid "" ":meth:`fromkeys` is a class method that returns a new dictionary. *value* " "defaults to ``None``. All of the values refer to just a single instance, so " @@ -4690,70 +4690,70 @@ msgid "" "` instead." msgstr "" -#: ../../library/stdtypes.rst:4463 +#: ../../library/stdtypes.rst:4464 msgid "" "Return the value for *key* if *key* is in the dictionary, else *default*. If " "*default* is not given, it defaults to ``None``, so that this method never " "raises a :exc:`KeyError`." msgstr "" -#: ../../library/stdtypes.rst:4469 +#: ../../library/stdtypes.rst:4470 msgid "" "Return a new view of the dictionary's items (``(key, value)`` pairs). See " "the :ref:`documentation of view objects `." msgstr "" -#: ../../library/stdtypes.rst:4474 +#: ../../library/stdtypes.rst:4475 msgid "" "Return a new view of the dictionary's keys. See the :ref:`documentation of " "view objects `." msgstr "" -#: ../../library/stdtypes.rst:4479 +#: ../../library/stdtypes.rst:4480 msgid "" "If *key* is in the dictionary, remove it and return its value, else return " "*default*. If *default* is not given and *key* is not in the dictionary, a :" "exc:`KeyError` is raised." msgstr "" -#: ../../library/stdtypes.rst:4485 +#: ../../library/stdtypes.rst:4486 msgid "" "Remove and return a ``(key, value)`` pair from the dictionary. Pairs are " "returned in :abbr:`LIFO (last-in, first-out)` order." msgstr "" -#: ../../library/stdtypes.rst:4488 +#: ../../library/stdtypes.rst:4489 msgid "" ":meth:`popitem` is useful to destructively iterate over a dictionary, as " "often used in set algorithms. If the dictionary is empty, calling :meth:" "`popitem` raises a :exc:`KeyError`." msgstr "" -#: ../../library/stdtypes.rst:4492 +#: ../../library/stdtypes.rst:4493 msgid "" "LIFO order is now guaranteed. In prior versions, :meth:`popitem` would " "return an arbitrary key/value pair." msgstr "" -#: ../../library/stdtypes.rst:4498 +#: ../../library/stdtypes.rst:4499 msgid "" "Return a reverse iterator over the keys of the dictionary. This is a " "shortcut for ``reversed(d.keys())``." msgstr "" -#: ../../library/stdtypes.rst:4505 +#: ../../library/stdtypes.rst:4506 msgid "" "If *key* is in the dictionary, return its value. If not, insert *key* with " "a value of *default* and return *default*. *default* defaults to ``None``." msgstr "" -#: ../../library/stdtypes.rst:4511 +#: ../../library/stdtypes.rst:4512 msgid "" "Update the dictionary with the key/value pairs from *other*, overwriting " "existing keys. Return ``None``." msgstr "" -#: ../../library/stdtypes.rst:4514 +#: ../../library/stdtypes.rst:4515 msgid "" ":meth:`update` accepts either another dictionary object or an iterable of " "key/value pairs (as tuples or other iterables of length two). If keyword " @@ -4761,71 +4761,71 @@ msgid "" "pairs: ``d.update(red=1, blue=2)``." msgstr "" -#: ../../library/stdtypes.rst:4521 +#: ../../library/stdtypes.rst:4522 msgid "" "Return a new view of the dictionary's values. See the :ref:`documentation " "of view objects `." msgstr "" -#: ../../library/stdtypes.rst:4524 +#: ../../library/stdtypes.rst:4525 msgid "" "An equality comparison between one ``dict.values()`` view and another will " "always return ``False``. This also applies when comparing ``dict.values()`` " "to itself::" msgstr "" -#: ../../library/stdtypes.rst:4534 +#: ../../library/stdtypes.rst:4535 msgid "" "Create a new dictionary with the merged keys and values of *d* and *other*, " "which must both be dictionaries. The values of *other* take priority when " "*d* and *other* share keys." msgstr "" -#: ../../library/stdtypes.rst:4542 +#: ../../library/stdtypes.rst:4543 msgid "" "Update the dictionary *d* with keys and values from *other*, which may be " "either a :term:`mapping` or an :term:`iterable` of key/value pairs. The " "values of *other* take priority when *d* and *other* share keys." msgstr "" -#: ../../library/stdtypes.rst:4548 +#: ../../library/stdtypes.rst:4549 msgid "" "Dictionaries compare equal if and only if they have the same ``(key, " "value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " "'>') raise :exc:`TypeError`." msgstr "" -#: ../../library/stdtypes.rst:4552 +#: ../../library/stdtypes.rst:4553 msgid "" "Dictionaries preserve insertion order. Note that updating a key does not " "affect the order. Keys added after deletion are inserted at the end. ::" msgstr "" -#: ../../library/stdtypes.rst:4570 +#: ../../library/stdtypes.rst:4571 msgid "" "Dictionary order is guaranteed to be insertion order. This behavior was an " "implementation detail of CPython from 3.6." msgstr "" -#: ../../library/stdtypes.rst:4574 +#: ../../library/stdtypes.rst:4575 msgid "Dictionaries and dictionary views are reversible. ::" msgstr "" -#: ../../library/stdtypes.rst:4586 +#: ../../library/stdtypes.rst:4587 msgid "Dictionaries are now reversible." msgstr "" -#: ../../library/stdtypes.rst:4591 +#: ../../library/stdtypes.rst:4592 msgid "" ":class:`types.MappingProxyType` can be used to create a read-only view of a :" "class:`dict`." msgstr "" -#: ../../library/stdtypes.rst:4598 +#: ../../library/stdtypes.rst:4599 msgid "Dictionary view objects" msgstr "" -#: ../../library/stdtypes.rst:4600 +#: ../../library/stdtypes.rst:4601 msgid "" "The objects returned by :meth:`dict.keys`, :meth:`dict.values` and :meth:" "`dict.items` are *view objects*. They provide a dynamic view on the " @@ -4833,23 +4833,23 @@ msgid "" "reflects these changes." msgstr "" -#: ../../library/stdtypes.rst:4605 +#: ../../library/stdtypes.rst:4606 msgid "" "Dictionary views can be iterated over to yield their respective data, and " "support membership tests:" msgstr "" -#: ../../library/stdtypes.rst:4610 +#: ../../library/stdtypes.rst:4611 msgid "Return the number of entries in the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4614 +#: ../../library/stdtypes.rst:4615 msgid "" "Return an iterator over the keys, values or items (represented as tuples of " "``(key, value)``) in the dictionary." msgstr "" -#: ../../library/stdtypes.rst:4617 +#: ../../library/stdtypes.rst:4618 msgid "" "Keys and values are iterated over in insertion order. This allows the " "creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = zip(d." @@ -4857,39 +4857,39 @@ msgid "" "[(v, k) for (k, v) in d.items()]``." msgstr "" -#: ../../library/stdtypes.rst:4622 +#: ../../library/stdtypes.rst:4623 msgid "" "Iterating views while adding or deleting entries in the dictionary may raise " "a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" -#: ../../library/stdtypes.rst:4625 +#: ../../library/stdtypes.rst:4626 msgid "Dictionary order is guaranteed to be insertion order." msgstr "" -#: ../../library/stdtypes.rst:4630 +#: ../../library/stdtypes.rst:4631 msgid "" "Return ``True`` if *x* is in the underlying dictionary's keys, values or " "items (in the latter case, *x* should be a ``(key, value)`` tuple)." msgstr "" -#: ../../library/stdtypes.rst:4635 +#: ../../library/stdtypes.rst:4636 msgid "" "Return a reverse iterator over the keys, values or items of the dictionary. " "The view will be iterated in reverse order of the insertion." msgstr "" -#: ../../library/stdtypes.rst:4638 +#: ../../library/stdtypes.rst:4639 msgid "Dictionary views are now reversible." msgstr "" -#: ../../library/stdtypes.rst:4643 +#: ../../library/stdtypes.rst:4644 msgid "" "Return a :class:`types.MappingProxyType` that wraps the original dictionary " "to which the view refers." msgstr "" -#: ../../library/stdtypes.rst:4648 +#: ../../library/stdtypes.rst:4649 msgid "" "Keys views are set-like since their entries are unique and hashable. If all " "values are hashable, so that ``(key, value)`` pairs are unique and hashable, " @@ -4899,15 +4899,15 @@ msgid "" "abc.Set` are available (for example, ``==``, ``<``, or ``^``)." msgstr "" -#: ../../library/stdtypes.rst:4655 +#: ../../library/stdtypes.rst:4656 msgid "An example of dictionary view usage::" msgstr "" -#: ../../library/stdtypes.rst:4696 +#: ../../library/stdtypes.rst:4697 msgid "Context Manager Types" msgstr "" -#: ../../library/stdtypes.rst:4703 +#: ../../library/stdtypes.rst:4704 msgid "" "Python's :keyword:`with` statement supports the concept of a runtime context " "defined by a context manager. This is implemented using a pair of methods " @@ -4915,7 +4915,7 @@ msgid "" "before the statement body is executed and exited when the statement ends:" msgstr "" -#: ../../library/stdtypes.rst:4711 +#: ../../library/stdtypes.rst:4712 msgid "" "Enter the runtime context and return either this object or another object " "related to the runtime context. The value returned by this method is bound " @@ -4923,14 +4923,14 @@ msgid "" "using this context manager." msgstr "" -#: ../../library/stdtypes.rst:4716 +#: ../../library/stdtypes.rst:4717 msgid "" "An example of a context manager that returns itself is a :term:`file " "object`. File objects return themselves from __enter__() to allow :func:" "`open` to be used as the context expression in a :keyword:`with` statement." msgstr "" -#: ../../library/stdtypes.rst:4720 +#: ../../library/stdtypes.rst:4721 msgid "" "An example of a context manager that returns a related object is the one " "returned by :func:`decimal.localcontext`. These managers set the active " @@ -4940,7 +4940,7 @@ msgid "" "the :keyword:`!with` statement." msgstr "" -#: ../../library/stdtypes.rst:4730 +#: ../../library/stdtypes.rst:4731 msgid "" "Exit the runtime context and return a Boolean flag indicating if any " "exception that occurred should be suppressed. If an exception occurred while " @@ -4949,7 +4949,7 @@ msgid "" "arguments are ``None``." msgstr "" -#: ../../library/stdtypes.rst:4735 +#: ../../library/stdtypes.rst:4736 msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " @@ -4960,7 +4960,7 @@ msgid "" "statement." msgstr "" -#: ../../library/stdtypes.rst:4742 +#: ../../library/stdtypes.rst:4743 msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " @@ -4969,7 +4969,7 @@ msgid "" "method has actually failed." msgstr "" -#: ../../library/stdtypes.rst:4748 +#: ../../library/stdtypes.rst:4749 msgid "" "Python defines several context managers to support easy thread " "synchronisation, prompt closure of files or other objects, and simpler " @@ -4978,7 +4978,7 @@ msgid "" "management protocol. See the :mod:`contextlib` module for some examples." msgstr "" -#: ../../library/stdtypes.rst:4754 +#: ../../library/stdtypes.rst:4755 msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " @@ -4988,7 +4988,7 @@ msgid "" "by an undecorated generator function." msgstr "" -#: ../../library/stdtypes.rst:4761 +#: ../../library/stdtypes.rst:4762 msgid "" "Note that there is no specific slot for any of these methods in the type " "structure for Python objects in the Python/C API. Extension types wanting to " @@ -4997,30 +4997,30 @@ msgid "" "a single class dictionary lookup is negligible." msgstr "" -#: ../../library/stdtypes.rst:4769 +#: ../../library/stdtypes.rst:4770 msgid "" "Type Annotation Types --- :ref:`Generic Alias `, :ref:" "`Union `" msgstr "" -#: ../../library/stdtypes.rst:4774 +#: ../../library/stdtypes.rst:4775 msgid "" "The core built-in types for :term:`type annotations ` are :ref:" "`Generic Alias ` and :ref:`Union `." msgstr "" -#: ../../library/stdtypes.rst:4781 +#: ../../library/stdtypes.rst:4782 msgid "Generic Alias Type" msgstr "" -#: ../../library/stdtypes.rst:4787 +#: ../../library/stdtypes.rst:4788 msgid "" "``GenericAlias`` objects are created by subscripting a class (usually a " "container), such as ``list[int]``. They are intended primarily for :term:" "`type annotations `." msgstr "" -#: ../../library/stdtypes.rst:4791 +#: ../../library/stdtypes.rst:4792 msgid "" "Usually, the :ref:`subscription ` of container objects calls " "the method :meth:`__getitem__` of the object. However, the subscription of " @@ -5029,35 +5029,35 @@ msgid "" "return a ``GenericAlias`` object." msgstr "" -#: ../../library/stdtypes.rst:4798 +#: ../../library/stdtypes.rst:4799 msgid "" "If the :meth:`__getitem__` of the class' metaclass is present, it will take " "precedence over the :meth:`__class_getitem__` defined in the class (see :pep:" "`560` for more details)." msgstr "" -#: ../../library/stdtypes.rst:4802 +#: ../../library/stdtypes.rst:4803 msgid "" "The ``GenericAlias`` object acts as a proxy for :term:`generic types " "`, implementing *parameterized generics* - a specific instance " "of a generic which provides the types for container elements." msgstr "" -#: ../../library/stdtypes.rst:4806 +#: ../../library/stdtypes.rst:4807 msgid "" "The user-exposed type for the ``GenericAlias`` object can be accessed from :" "class:`types.GenericAlias` and used for :func:`isinstance` checks. It can " "also be used to create ``GenericAlias`` objects directly." msgstr "" -#: ../../library/stdtypes.rst:4812 +#: ../../library/stdtypes.rst:4813 msgid "" "Creates a ``GenericAlias`` representing a type ``T`` containing elements of " "types *X*, *Y*, and more depending on the ``T`` used. For example, a " "function expecting a :class:`list` containing :class:`float` elements::" msgstr "" -#: ../../library/stdtypes.rst:4820 +#: ../../library/stdtypes.rst:4821 msgid "" "Another example for :term:`mapping` objects, using a :class:`dict`, which is " "a generic type expecting two type parameters representing the key type and " @@ -5065,13 +5065,13 @@ msgid "" "of type :class:`str` and values of type :class:`int`::" msgstr "" -#: ../../library/stdtypes.rst:4828 +#: ../../library/stdtypes.rst:4829 msgid "" "The builtin functions :func:`isinstance` and :func:`issubclass` do not " "accept ``GenericAlias`` types for their second argument::" msgstr "" -#: ../../library/stdtypes.rst:4836 +#: ../../library/stdtypes.rst:4837 msgid "" "The Python runtime does not enforce :term:`type annotations `. " "This extends to generic types and their type parameters. When creating an " @@ -5080,25 +5080,25 @@ msgid "" "without errors::" msgstr "" -#: ../../library/stdtypes.rst:4846 +#: ../../library/stdtypes.rst:4847 msgid "" "Furthermore, parameterized generics erase type parameters during object " "creation::" msgstr "" -#: ../../library/stdtypes.rst:4857 +#: ../../library/stdtypes.rst:4858 msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" msgstr "" -#: ../../library/stdtypes.rst:4865 +#: ../../library/stdtypes.rst:4866 msgid "" "The :meth:`__getitem__` method of generics will raise an exception to " "disallow mistakes like ``dict[str][str]``::" msgstr "" -#: ../../library/stdtypes.rst:4873 +#: ../../library/stdtypes.rst:4874 msgid "" "However, such expressions are valid when :ref:`type variables ` " "are used. The index must have as many elements as there are type variable " @@ -5106,214 +5106,214 @@ msgid "" "__args__>`. ::" msgstr "" -#: ../../library/stdtypes.rst:4884 +#: ../../library/stdtypes.rst:4885 msgid "Standard Generic Collections" msgstr "" -#: ../../library/stdtypes.rst:4886 +#: ../../library/stdtypes.rst:4887 msgid "These standard library collections support parameterized generics." msgstr "" -#: ../../library/stdtypes.rst:4888 +#: ../../library/stdtypes.rst:4889 msgid ":class:`tuple`" msgstr ":class:`tuple`" -#: ../../library/stdtypes.rst:4889 +#: ../../library/stdtypes.rst:4890 msgid ":class:`list`" msgstr ":class:`list`" -#: ../../library/stdtypes.rst:4890 +#: ../../library/stdtypes.rst:4891 msgid ":class:`dict`" msgstr ":class:`dict`" -#: ../../library/stdtypes.rst:4891 +#: ../../library/stdtypes.rst:4892 msgid ":class:`set`" msgstr ":class:`set`" -#: ../../library/stdtypes.rst:4892 +#: ../../library/stdtypes.rst:4893 msgid ":class:`frozenset`" msgstr ":class:`frozenset`" -#: ../../library/stdtypes.rst:4893 +#: ../../library/stdtypes.rst:4894 msgid ":class:`type`" msgstr ":class:`type`" -#: ../../library/stdtypes.rst:4894 +#: ../../library/stdtypes.rst:4895 msgid ":class:`collections.deque`" msgstr ":class:`collections.deque`" -#: ../../library/stdtypes.rst:4895 +#: ../../library/stdtypes.rst:4896 msgid ":class:`collections.defaultdict`" msgstr ":class:`collections.defaultdict`" -#: ../../library/stdtypes.rst:4896 +#: ../../library/stdtypes.rst:4897 msgid ":class:`collections.OrderedDict`" msgstr ":class:`collections.OrderedDict`" -#: ../../library/stdtypes.rst:4897 +#: ../../library/stdtypes.rst:4898 msgid ":class:`collections.Counter`" msgstr ":class:`collections.Counter`" -#: ../../library/stdtypes.rst:4898 +#: ../../library/stdtypes.rst:4899 msgid ":class:`collections.ChainMap`" msgstr ":class:`collections.ChainMap`" -#: ../../library/stdtypes.rst:4899 +#: ../../library/stdtypes.rst:4900 msgid ":class:`collections.abc.Awaitable`" msgstr ":class:`collections.abc.Awaitable`" -#: ../../library/stdtypes.rst:4900 +#: ../../library/stdtypes.rst:4901 msgid ":class:`collections.abc.Coroutine`" msgstr ":class:`collections.abc.Coroutine`" -#: ../../library/stdtypes.rst:4901 +#: ../../library/stdtypes.rst:4902 msgid ":class:`collections.abc.AsyncIterable`" msgstr ":class:`collections.abc.AsyncIterable`" -#: ../../library/stdtypes.rst:4902 +#: ../../library/stdtypes.rst:4903 msgid ":class:`collections.abc.AsyncIterator`" msgstr ":class:`collections.abc.AsyncIterator`" -#: ../../library/stdtypes.rst:4903 +#: ../../library/stdtypes.rst:4904 msgid ":class:`collections.abc.AsyncGenerator`" msgstr ":class:`collections.abc.AsyncGenerator`" -#: ../../library/stdtypes.rst:4904 +#: ../../library/stdtypes.rst:4905 msgid ":class:`collections.abc.Iterable`" msgstr ":class:`collections.abc.Iterable`" -#: ../../library/stdtypes.rst:4905 +#: ../../library/stdtypes.rst:4906 msgid ":class:`collections.abc.Iterator`" msgstr ":class:`collections.abc.Iterator`" -#: ../../library/stdtypes.rst:4906 +#: ../../library/stdtypes.rst:4907 msgid ":class:`collections.abc.Generator`" msgstr ":class:`collections.abc.Generator`" -#: ../../library/stdtypes.rst:4907 +#: ../../library/stdtypes.rst:4908 msgid ":class:`collections.abc.Reversible`" msgstr ":class:`collections.abc.Reversible`" -#: ../../library/stdtypes.rst:4908 +#: ../../library/stdtypes.rst:4909 msgid ":class:`collections.abc.Container`" msgstr ":class:`collections.abc.Container`" -#: ../../library/stdtypes.rst:4909 +#: ../../library/stdtypes.rst:4910 msgid ":class:`collections.abc.Collection`" msgstr ":class:`collections.abc.Collection`" -#: ../../library/stdtypes.rst:4910 +#: ../../library/stdtypes.rst:4911 msgid ":class:`collections.abc.Callable`" msgstr ":class:`collections.abc.Callable`" -#: ../../library/stdtypes.rst:4911 +#: ../../library/stdtypes.rst:4912 msgid ":class:`collections.abc.Set`" msgstr ":class:`collections.abc.Set`" -#: ../../library/stdtypes.rst:4912 +#: ../../library/stdtypes.rst:4913 msgid ":class:`collections.abc.MutableSet`" msgstr ":class:`collections.abc.MutableSet`" -#: ../../library/stdtypes.rst:4913 +#: ../../library/stdtypes.rst:4914 msgid ":class:`collections.abc.Mapping`" msgstr ":class:`collections.abc.Mapping`" -#: ../../library/stdtypes.rst:4914 +#: ../../library/stdtypes.rst:4915 msgid ":class:`collections.abc.MutableMapping`" msgstr ":class:`collections.abc.MutableMapping`" -#: ../../library/stdtypes.rst:4915 +#: ../../library/stdtypes.rst:4916 msgid ":class:`collections.abc.Sequence`" msgstr ":class:`collections.abc.Sequence`" -#: ../../library/stdtypes.rst:4916 +#: ../../library/stdtypes.rst:4917 msgid ":class:`collections.abc.MutableSequence`" msgstr ":class:`collections.abc.MutableSequence`" -#: ../../library/stdtypes.rst:4917 +#: ../../library/stdtypes.rst:4918 msgid ":class:`collections.abc.ByteString`" msgstr ":class:`collections.abc.ByteString`" -#: ../../library/stdtypes.rst:4918 +#: ../../library/stdtypes.rst:4919 msgid ":class:`collections.abc.MappingView`" msgstr ":class:`collections.abc.MappingView`" -#: ../../library/stdtypes.rst:4919 +#: ../../library/stdtypes.rst:4920 msgid ":class:`collections.abc.KeysView`" msgstr ":class:`collections.abc.KeysView`" -#: ../../library/stdtypes.rst:4920 +#: ../../library/stdtypes.rst:4921 msgid ":class:`collections.abc.ItemsView`" msgstr ":class:`collections.abc.ItemsView`" -#: ../../library/stdtypes.rst:4921 +#: ../../library/stdtypes.rst:4922 msgid ":class:`collections.abc.ValuesView`" msgstr ":class:`collections.abc.ValuesView`" -#: ../../library/stdtypes.rst:4922 +#: ../../library/stdtypes.rst:4923 msgid ":class:`contextlib.AbstractContextManager`" msgstr ":class:`contextlib.AbstractContextManager`" -#: ../../library/stdtypes.rst:4923 +#: ../../library/stdtypes.rst:4924 msgid ":class:`contextlib.AbstractAsyncContextManager`" msgstr ":class:`contextlib.AbstractAsyncContextManager`" -#: ../../library/stdtypes.rst:4924 +#: ../../library/stdtypes.rst:4925 msgid ":ref:`re.Pattern `" msgstr ":ref:`re.Pattern `" -#: ../../library/stdtypes.rst:4925 +#: ../../library/stdtypes.rst:4926 msgid ":ref:`re.Match `" msgstr ":ref:`re.Match `" -#: ../../library/stdtypes.rst:4929 +#: ../../library/stdtypes.rst:4930 msgid "Special Attributes of Generic Alias" msgstr "" -#: ../../library/stdtypes.rst:4931 +#: ../../library/stdtypes.rst:4932 msgid "All parameterized generics implement special read-only attributes." msgstr "" -#: ../../library/stdtypes.rst:4935 +#: ../../library/stdtypes.rst:4936 msgid "This attribute points at the non-parameterized generic class::" msgstr "" -#: ../../library/stdtypes.rst:4943 +#: ../../library/stdtypes.rst:4944 msgid "" "This attribute is a :class:`tuple` (possibly of length 1) of generic types " "passed to the original :meth:`__class_getitem__` of the generic container::" msgstr "" -#: ../../library/stdtypes.rst:4953 +#: ../../library/stdtypes.rst:4954 msgid "" "This attribute is a lazily computed tuple (possibly empty) of unique type " "variables found in ``__args__``::" msgstr "" -#: ../../library/stdtypes.rst:4964 +#: ../../library/stdtypes.rst:4965 msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " "have correct ``__parameters__`` after substitution because :class:`typing." "ParamSpec` is intended primarily for static type checking." msgstr "" -#: ../../library/stdtypes.rst:4970 +#: ../../library/stdtypes.rst:4971 msgid ":pep:`585` -- \"Type Hinting Generics In Standard Collections\"" msgstr "" -#: ../../library/stdtypes.rst:4971 +#: ../../library/stdtypes.rst:4972 msgid ":meth:`__class_getitem__` -- Used to implement parameterized generics." msgstr "" -#: ../../library/stdtypes.rst:4972 +#: ../../library/stdtypes.rst:4973 msgid ":ref:`generics` -- Generics in the :mod:`typing` module." msgstr "" -#: ../../library/stdtypes.rst:4980 +#: ../../library/stdtypes.rst:4981 msgid "Union Type" msgstr "" -#: ../../library/stdtypes.rst:4986 +#: ../../library/stdtypes.rst:4987 msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " @@ -5322,7 +5322,7 @@ msgid "" "Union`." msgstr "" -#: ../../library/stdtypes.rst:4993 +#: ../../library/stdtypes.rst:4994 msgid "" "Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " "means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " @@ -5330,76 +5330,76 @@ msgid "" "class:`float`::" msgstr "" -#: ../../library/stdtypes.rst:5003 +#: ../../library/stdtypes.rst:5004 msgid "" "Union objects can be tested for equality with other union objects. Details:" msgstr "" -#: ../../library/stdtypes.rst:5005 +#: ../../library/stdtypes.rst:5006 msgid "Unions of unions are flattened::" msgstr "" -#: ../../library/stdtypes.rst:5009 +#: ../../library/stdtypes.rst:5010 msgid "Redundant types are removed::" msgstr "" -#: ../../library/stdtypes.rst:5013 +#: ../../library/stdtypes.rst:5014 msgid "When comparing unions, the order is ignored::" msgstr "" -#: ../../library/stdtypes.rst:5017 +#: ../../library/stdtypes.rst:5018 msgid "It is compatible with :data:`typing.Union`::" msgstr "" -#: ../../library/stdtypes.rst:5021 +#: ../../library/stdtypes.rst:5022 msgid "Optional types can be spelled as a union with ``None``::" msgstr "" -#: ../../library/stdtypes.rst:5028 +#: ../../library/stdtypes.rst:5029 msgid "" "Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " "union object::" msgstr "" -#: ../../library/stdtypes.rst:5034 +#: ../../library/stdtypes.rst:5035 msgid "" "However, union objects containing :ref:`parameterized generics ` cannot be used::" msgstr "" -#: ../../library/stdtypes.rst:5042 +#: ../../library/stdtypes.rst:5043 msgid "" "The user-exposed type for the union object can be accessed from :data:`types." "UnionType` and used for :func:`isinstance` checks. An object cannot be " "instantiated from the type::" msgstr "" -#: ../../library/stdtypes.rst:5055 +#: ../../library/stdtypes.rst:5056 msgid "" "The :meth:`__or__` method for type objects was added to support the syntax " "``X | Y``. If a metaclass implements :meth:`__or__`, the Union may override " "it::" msgstr "" -#: ../../library/stdtypes.rst:5073 +#: ../../library/stdtypes.rst:5074 msgid ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." msgstr "" -#: ../../library/stdtypes.rst:5081 +#: ../../library/stdtypes.rst:5082 msgid "Other Built-in Types" msgstr "" -#: ../../library/stdtypes.rst:5083 +#: ../../library/stdtypes.rst:5084 msgid "" "The interpreter supports several other kinds of objects. Most of these " "support only one or two operations." msgstr "" -#: ../../library/stdtypes.rst:5090 +#: ../../library/stdtypes.rst:5091 msgid "Modules" msgstr "模組" -#: ../../library/stdtypes.rst:5092 +#: ../../library/stdtypes.rst:5093 msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " @@ -5410,7 +5410,7 @@ msgid "" "*foo* somewhere.)" msgstr "" -#: ../../library/stdtypes.rst:5099 +#: ../../library/stdtypes.rst:5100 msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " @@ -5421,32 +5421,32 @@ msgid "" "recommended." msgstr "" -#: ../../library/stdtypes.rst:5107 +#: ../../library/stdtypes.rst:5108 msgid "" "Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." msgstr "" -#: ../../library/stdtypes.rst:5115 +#: ../../library/stdtypes.rst:5116 msgid "Classes and Class Instances" msgstr "" -#: ../../library/stdtypes.rst:5117 +#: ../../library/stdtypes.rst:5118 msgid "See :ref:`objects` and :ref:`class` for these." msgstr "" -#: ../../library/stdtypes.rst:5123 +#: ../../library/stdtypes.rst:5124 msgid "Functions" msgstr "函式" -#: ../../library/stdtypes.rst:5125 +#: ../../library/stdtypes.rst:5126 msgid "" "Function objects are created by function definitions. The only operation on " "a function object is to call it: ``func(argument-list)``." msgstr "" -#: ../../library/stdtypes.rst:5128 +#: ../../library/stdtypes.rst:5129 msgid "" "There are really two flavors of function objects: built-in functions and " "user-defined functions. Both support the same operation (to call the " @@ -5454,15 +5454,15 @@ msgid "" "types." msgstr "" -#: ../../library/stdtypes.rst:5132 +#: ../../library/stdtypes.rst:5133 msgid "See :ref:`function` for more information." msgstr "更多資訊請見 :ref:`function`\\ 。" -#: ../../library/stdtypes.rst:5138 +#: ../../library/stdtypes.rst:5139 msgid "Methods" msgstr "" -#: ../../library/stdtypes.rst:5142 +#: ../../library/stdtypes.rst:5143 msgid "" "Methods are functions that are called using the attribute notation. There " "are two flavors: built-in methods (such as :meth:`append` on lists) and " @@ -5470,7 +5470,7 @@ msgid "" "support them." msgstr "" -#: ../../library/stdtypes.rst:5147 +#: ../../library/stdtypes.rst:5148 msgid "" "If you access a method (a function defined in a class namespace) through an " "instance, you get a special object: a :dfn:`bound method` (also called :dfn:" @@ -5482,7 +5482,7 @@ msgid "" "arg-2, ..., arg-n)``." msgstr "" -#: ../../library/stdtypes.rst:5156 +#: ../../library/stdtypes.rst:5157 msgid "" "Like function objects, bound method objects support getting arbitrary " "attributes. However, since method attributes are actually stored on the " @@ -5492,15 +5492,15 @@ msgid "" "attribute, you need to explicitly set it on the underlying function object::" msgstr "" -#: ../../library/stdtypes.rst:5176 ../../library/stdtypes.rst:5207 +#: ../../library/stdtypes.rst:5177 ../../library/stdtypes.rst:5208 msgid "See :ref:`types` for more information." msgstr "更多資訊請見 :ref:`types`\\ 。" -#: ../../library/stdtypes.rst:5184 +#: ../../library/stdtypes.rst:5185 msgid "Code Objects" msgstr "" -#: ../../library/stdtypes.rst:5190 +#: ../../library/stdtypes.rst:5191 msgid "" "Code objects are used by the implementation to represent \"pseudo-compiled\" " "executable Python code such as a function body. They differ from function " @@ -5510,23 +5510,23 @@ msgid "" "`__code__` attribute. See also the :mod:`code` module." msgstr "" -#: ../../library/stdtypes.rst:5197 +#: ../../library/stdtypes.rst:5198 msgid "" "Accessing ``__code__`` raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"__code__\"``." msgstr "" -#: ../../library/stdtypes.rst:5204 +#: ../../library/stdtypes.rst:5205 msgid "" "A code object can be executed or evaluated by passing it (instead of a " "source string) to the :func:`exec` or :func:`eval` built-in functions." msgstr "" -#: ../../library/stdtypes.rst:5213 +#: ../../library/stdtypes.rst:5214 msgid "Type Objects" msgstr "" -#: ../../library/stdtypes.rst:5219 +#: ../../library/stdtypes.rst:5220 msgid "" "Type objects represent the various object types. An object's type is " "accessed by the built-in function :func:`type`. There are no special " @@ -5534,30 +5534,30 @@ msgid "" "standard built-in types." msgstr "" -#: ../../library/stdtypes.rst:5224 +#: ../../library/stdtypes.rst:5225 msgid "Types are written like this: ````." msgstr "" -#: ../../library/stdtypes.rst:5230 +#: ../../library/stdtypes.rst:5231 msgid "The Null Object" msgstr "" -#: ../../library/stdtypes.rst:5232 +#: ../../library/stdtypes.rst:5233 msgid "" "This object is returned by functions that don't explicitly return a value. " "It supports no special operations. There is exactly one null object, named " "``None`` (a built-in name). ``type(None)()`` produces the same singleton." msgstr "" -#: ../../library/stdtypes.rst:5236 +#: ../../library/stdtypes.rst:5237 msgid "It is written as ``None``." msgstr "" -#: ../../library/stdtypes.rst:5243 +#: ../../library/stdtypes.rst:5244 msgid "The Ellipsis Object" msgstr "" -#: ../../library/stdtypes.rst:5245 +#: ../../library/stdtypes.rst:5246 msgid "" "This object is commonly used by slicing (see :ref:`slicings`). It supports " "no special operations. There is exactly one ellipsis object, named :const:" @@ -5565,15 +5565,15 @@ msgid "" "`Ellipsis` singleton." msgstr "" -#: ../../library/stdtypes.rst:5250 +#: ../../library/stdtypes.rst:5251 msgid "It is written as ``Ellipsis`` or ``...``." msgstr "" -#: ../../library/stdtypes.rst:5256 +#: ../../library/stdtypes.rst:5257 msgid "The NotImplemented Object" msgstr "" -#: ../../library/stdtypes.rst:5258 +#: ../../library/stdtypes.rst:5259 msgid "" "This object is returned from comparisons and binary operations when they are " "asked to operate on types they don't support. See :ref:`comparisons` for " @@ -5581,15 +5581,15 @@ msgid "" "``type(NotImplemented)()`` produces the singleton instance." msgstr "" -#: ../../library/stdtypes.rst:5263 +#: ../../library/stdtypes.rst:5264 msgid "It is written as ``NotImplemented``." msgstr "" -#: ../../library/stdtypes.rst:5269 +#: ../../library/stdtypes.rst:5270 msgid "Boolean Values" msgstr "" -#: ../../library/stdtypes.rst:5271 +#: ../../library/stdtypes.rst:5272 msgid "" "Boolean values are the two constant objects ``False`` and ``True``. They " "are used to represent truth values (although other values can also be " @@ -5600,104 +5600,104 @@ msgid "" "(see section :ref:`truth` above)." msgstr "" -#: ../../library/stdtypes.rst:5284 +#: ../../library/stdtypes.rst:5285 msgid "They are written as ``False`` and ``True``, respectively." msgstr "" -#: ../../library/stdtypes.rst:5290 +#: ../../library/stdtypes.rst:5291 msgid "Internal Objects" msgstr "" -#: ../../library/stdtypes.rst:5292 +#: ../../library/stdtypes.rst:5293 msgid "" "See :ref:`types` for this information. It describes stack frame objects, " "traceback objects, and slice objects." msgstr "" -#: ../../library/stdtypes.rst:5299 +#: ../../library/stdtypes.rst:5300 msgid "Special Attributes" msgstr "" -#: ../../library/stdtypes.rst:5301 +#: ../../library/stdtypes.rst:5302 msgid "" "The implementation adds a few special read-only attributes to several object " "types, where they are relevant. Some of these are not reported by the :func:" "`dir` built-in function." msgstr "" -#: ../../library/stdtypes.rst:5308 +#: ../../library/stdtypes.rst:5309 msgid "" "A dictionary or other mapping object used to store an object's (writable) " "attributes." msgstr "" -#: ../../library/stdtypes.rst:5314 +#: ../../library/stdtypes.rst:5315 msgid "The class to which a class instance belongs." msgstr "" -#: ../../library/stdtypes.rst:5319 +#: ../../library/stdtypes.rst:5320 msgid "The tuple of base classes of a class object." msgstr "" -#: ../../library/stdtypes.rst:5324 +#: ../../library/stdtypes.rst:5325 msgid "" "The name of the class, function, method, descriptor, or generator instance." msgstr "" -#: ../../library/stdtypes.rst:5330 +#: ../../library/stdtypes.rst:5331 msgid "" "The :term:`qualified name` of the class, function, method, descriptor, or " "generator instance." msgstr "" -#: ../../library/stdtypes.rst:5338 +#: ../../library/stdtypes.rst:5339 msgid "" "This attribute is a tuple of classes that are considered when looking for " "base classes during method resolution." msgstr "" -#: ../../library/stdtypes.rst:5344 +#: ../../library/stdtypes.rst:5345 msgid "" "This method can be overridden by a metaclass to customize the method " "resolution order for its instances. It is called at class instantiation, " "and its result is stored in :attr:`~class.__mro__`." msgstr "" -#: ../../library/stdtypes.rst:5351 +#: ../../library/stdtypes.rst:5352 msgid "" "Each class keeps a list of weak references to its immediate subclasses. " "This method returns a list of all those references still alive. The list is " "in definition order. Example::" msgstr "" -#: ../../library/stdtypes.rst:5360 +#: ../../library/stdtypes.rst:5361 msgid "Footnotes" msgstr "註解" -#: ../../library/stdtypes.rst:5361 +#: ../../library/stdtypes.rst:5362 msgid "" "Additional information on these special methods may be found in the Python " "Reference Manual (:ref:`customization`)." msgstr "" -#: ../../library/stdtypes.rst:5364 +#: ../../library/stdtypes.rst:5365 msgid "" "As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " "and similarly for tuples." msgstr "" -#: ../../library/stdtypes.rst:5367 +#: ../../library/stdtypes.rst:5368 msgid "They must have since the parser can't tell the type of the operands." msgstr "" -#: ../../library/stdtypes.rst:5369 +#: ../../library/stdtypes.rst:5370 msgid "" "Cased characters are those with general category property being one of \"Lu" "\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " "titlecase)." msgstr "" -#: ../../library/stdtypes.rst:5372 +#: ../../library/stdtypes.rst:5373 msgid "" "To format only a tuple you should therefore provide a singleton tuple whose " "only element is the tuple to be formatted." diff --git a/reference/datamodel.po b/reference/datamodel.po index 7cdb52b4d8..3cc61a671c 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.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: 2021-11-23 00:09+0000\n" "PO-Revision-Date: 2018-05-23 16:17+0000\n" "Last-Translator: Adrian Liaw \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -841,13 +841,13 @@ msgstr "" msgid "" "A function or method which uses the :keyword:`yield` statement (see section :" "ref:`yield`) is called a :dfn:`generator function`. Such a function, when " -"called, always returns an iterator object which can be used to execute the " -"body of the function: calling the iterator's :meth:`iterator.__next__` " -"method will cause the function to execute until it provides a value using " -"the :keyword:`!yield` statement. When the function executes a :keyword:" -"`return` statement or falls off the end, a :exc:`StopIteration` exception is " -"raised and the iterator will have reached the end of the set of values to be " -"returned." +"called, always returns an :term:`iterator` object which can be used to " +"execute the body of the function: calling the iterator's :meth:`iterator." +"__next__` method will cause the function to execute until it provides a " +"value using the :keyword:`!yield` statement. When the function executes a :" +"keyword:`return` statement or falls off the end, a :exc:`StopIteration` " +"exception is raised and the iterator will have reached the end of the set of " +"values to be returned." msgstr "" #: ../../reference/datamodel.rst:667 @@ -871,9 +871,9 @@ msgstr "" msgid "" "A function or method which is defined using :keyword:`async def` and which " "uses the :keyword:`yield` statement is called a :dfn:`asynchronous generator " -"function`. Such a function, when called, returns an asynchronous iterator " -"object which can be used in an :keyword:`async for` statement to execute the " -"body of the function." +"function`. Such a function, when called, returns an :term:`asynchronous " +"iterator` object which can be used in an :keyword:`async for` statement to " +"execute the body of the function." msgstr "" #: ../../reference/datamodel.rst:680 @@ -2919,27 +2919,20 @@ msgstr "" #: ../../reference/datamodel.rst:2467 msgid "" -"This method is called when an iterator is required for a container. This " -"method should return a new iterator object that can iterate over all the " -"objects in the container. For mappings, it should iterate over the keys of " -"the container." +"This method is called when an :term:`iterator` is required for a container. " +"This method should return a new iterator object that can iterate over all " +"the objects in the container. For mappings, it should iterate over the keys " +"of the container." msgstr "" -#: ../../reference/datamodel.rst:2471 -msgid "" -"Iterator objects also need to implement this method; they are required to " -"return themselves. For more information on iterator objects, see :ref:" -"`typeiter`." -msgstr "" - -#: ../../reference/datamodel.rst:2477 +#: ../../reference/datamodel.rst:2475 msgid "" "Called (if present) by the :func:`reversed` built-in to implement reverse " "iteration. It should return a new iterator object that iterates over all " "the objects in the container in reverse order." msgstr "" -#: ../../reference/datamodel.rst:2481 +#: ../../reference/datamodel.rst:2479 msgid "" "If the :meth:`__reversed__` method is not provided, the :func:`reversed` " "built-in will fall back to using the sequence protocol (:meth:`__len__` and :" @@ -2948,7 +2941,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: ../../reference/datamodel.rst:2488 +#: ../../reference/datamodel.rst:2486 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a container. However, container " @@ -2956,14 +2949,14 @@ msgid "" "implementation, which also does not require the object be iterable." msgstr "" -#: ../../reference/datamodel.rst:2495 +#: ../../reference/datamodel.rst:2493 msgid "" "Called to implement membership test operators. Should return true if *item* " "is in *self*, false otherwise. For mapping objects, this should consider " "the keys of the mapping rather than the values or the key-item pairs." msgstr "" -#: ../../reference/datamodel.rst:2499 +#: ../../reference/datamodel.rst:2497 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -2971,11 +2964,11 @@ msgid "" "reference `." msgstr "" -#: ../../reference/datamodel.rst:2508 +#: ../../reference/datamodel.rst:2506 msgid "Emulating numeric types" msgstr "" -#: ../../reference/datamodel.rst:2510 +#: ../../reference/datamodel.rst:2508 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -2983,7 +2976,7 @@ msgid "" "should be left undefined." msgstr "" -#: ../../reference/datamodel.rst:2536 +#: ../../reference/datamodel.rst:2534 msgid "" "These methods are called to implement the binary arithmetic operations (``" "+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:`pow`, " @@ -2996,13 +2989,13 @@ msgid "" "version of the built-in :func:`pow` function is to be supported." msgstr "" -#: ../../reference/datamodel.rst:2547 +#: ../../reference/datamodel.rst:2545 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return ``NotImplemented``." msgstr "" -#: ../../reference/datamodel.rst:2570 +#: ../../reference/datamodel.rst:2568 msgid "" "These methods are called to implement the binary arithmetic operations (``" "+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:`pow`, " @@ -3014,13 +3007,13 @@ msgid "" "__rsub__(x)`` is called if ``x.__sub__(y)`` returns *NotImplemented*." msgstr "" -#: ../../reference/datamodel.rst:2581 +#: ../../reference/datamodel.rst:2579 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: ../../reference/datamodel.rst:2586 +#: ../../reference/datamodel.rst:2584 msgid "" "If the right operand's type is a subclass of the left operand's type and " "that subclass provides a different implementation of the reflected method " @@ -3029,7 +3022,7 @@ msgid "" "ancestors' operations." msgstr "" -#: ../../reference/datamodel.rst:2607 +#: ../../reference/datamodel.rst:2605 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " @@ -3045,19 +3038,19 @@ msgid "" "fact part of the data model." msgstr "" -#: ../../reference/datamodel.rst:2628 +#: ../../reference/datamodel.rst:2626 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" -#: ../../reference/datamodel.rst:2641 +#: ../../reference/datamodel.rst:2639 msgid "" "Called to implement the built-in functions :func:`complex`, :func:`int` and :" "func:`float`. Should return a value of the appropriate type." msgstr "" -#: ../../reference/datamodel.rst:2648 +#: ../../reference/datamodel.rst:2646 msgid "" "Called to implement :func:`operator.index`, and whenever Python needs to " "losslessly convert the numeric object to an integer object (such as in " @@ -3066,14 +3059,14 @@ msgid "" "integer type. Must return an integer." msgstr "" -#: ../../reference/datamodel.rst:2654 +#: ../../reference/datamodel.rst:2652 msgid "" "If :meth:`__int__`, :meth:`__float__` and :meth:`__complex__` are not " "defined then corresponding built-in functions :func:`int`, :func:`float` " "and :func:`complex` fall back to :meth:`__index__`." msgstr "" -#: ../../reference/datamodel.rst:2666 +#: ../../reference/datamodel.rst:2664 msgid "" "Called to implement the built-in function :func:`round` and :mod:`math` " "functions :func:`~math.trunc`, :func:`~math.floor` and :func:`~math.ceil`. " @@ -3082,17 +3075,17 @@ msgid "" "(typically an :class:`int`)." msgstr "" -#: ../../reference/datamodel.rst:2672 +#: ../../reference/datamodel.rst:2670 msgid "" "The built-in function :func:`int` falls back to :meth:`__trunc__` if " "neither :meth:`__int__` nor :meth:`__index__` is defined." msgstr "" -#: ../../reference/datamodel.rst:2679 +#: ../../reference/datamodel.rst:2677 msgid "With Statement Context Managers" msgstr "" -#: ../../reference/datamodel.rst:2681 +#: ../../reference/datamodel.rst:2679 msgid "" "A :dfn:`context manager` is an object that defines the runtime context to be " "established when executing a :keyword:`with` statement. The context manager " @@ -3102,32 +3095,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: ../../reference/datamodel.rst:2692 +#: ../../reference/datamodel.rst:2690 msgid "" "Typical uses of context managers include saving and restoring various kinds " "of global state, locking and unlocking resources, closing opened files, etc." msgstr "" -#: ../../reference/datamodel.rst:2695 +#: ../../reference/datamodel.rst:2693 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: ../../reference/datamodel.rst:2700 +#: ../../reference/datamodel.rst:2698 msgid "" "Enter the runtime context related to this object. The :keyword:`with` " "statement will bind this method's return value to the target(s) specified in " "the :keyword:`!as` clause of the statement, if any." msgstr "" -#: ../../reference/datamodel.rst:2707 +#: ../../reference/datamodel.rst:2705 msgid "" "Exit the runtime context related to this object. The parameters describe the " "exception that caused the context to be exited. If the context was exited " "without an exception, all three arguments will be :const:`None`." msgstr "" -#: ../../reference/datamodel.rst:2711 +#: ../../reference/datamodel.rst:2709 msgid "" "If an exception is supplied, and the method wishes to suppress the exception " "(i.e., prevent it from being propagated), it should return a true value. " @@ -3135,27 +3128,27 @@ msgid "" "method." msgstr "" -#: ../../reference/datamodel.rst:2715 +#: ../../reference/datamodel.rst:2713 msgid "" "Note that :meth:`__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" -#: ../../reference/datamodel.rst:2722 +#: ../../reference/datamodel.rst:2720 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: ../../reference/datamodel.rst:2722 +#: ../../reference/datamodel.rst:2720 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: ../../reference/datamodel.rst:2729 +#: ../../reference/datamodel.rst:2727 msgid "Customizing positional arguments in class pattern matching" msgstr "" -#: ../../reference/datamodel.rst:2731 +#: ../../reference/datamodel.rst:2729 msgid "" "When using a class name in a pattern, positional arguments in the pattern " "are not allowed by default, i.e. ``case MyClass(x, y)`` is typically invalid " @@ -3163,7 +3156,7 @@ msgid "" "patterns, the class needs to define a *__match_args__* attribute." msgstr "" -#: ../../reference/datamodel.rst:2738 +#: ../../reference/datamodel.rst:2736 msgid "" "This class variable can be assigned a tuple of strings. When this class is " "used in a class pattern with positional arguments, each positional argument " @@ -3172,7 +3165,7 @@ msgid "" "to setting it to ``()``." msgstr "" -#: ../../reference/datamodel.rst:2744 +#: ../../reference/datamodel.rst:2742 msgid "" "For example, if ``MyClass.__match_args__`` is ``(\"left\", \"center\", " "\"right\")`` that means that ``case MyClass(x, y)`` is equivalent to ``case " @@ -3182,19 +3175,19 @@ msgid "" "exc:`TypeError`." msgstr "" -#: ../../reference/datamodel.rst:2754 +#: ../../reference/datamodel.rst:2752 msgid ":pep:`634` - Structural Pattern Matching" msgstr "" -#: ../../reference/datamodel.rst:2755 +#: ../../reference/datamodel.rst:2753 msgid "The specification for the Python ``match`` statement." msgstr "" -#: ../../reference/datamodel.rst:2761 +#: ../../reference/datamodel.rst:2759 msgid "Special method lookup" msgstr "" -#: ../../reference/datamodel.rst:2763 +#: ../../reference/datamodel.rst:2761 msgid "" "For custom classes, implicit invocations of special methods are only " "guaranteed to work correctly if defined on an object's type, not in the " @@ -3202,7 +3195,7 @@ msgid "" "following code raises an exception::" msgstr "" -#: ../../reference/datamodel.rst:2778 +#: ../../reference/datamodel.rst:2776 msgid "" "The rationale behind this behaviour lies with a number of special methods " "such as :meth:`__hash__` and :meth:`__repr__` that are implemented by all " @@ -3211,21 +3204,21 @@ msgid "" "type object itself::" msgstr "" -#: ../../reference/datamodel.rst:2791 +#: ../../reference/datamodel.rst:2789 msgid "" "Incorrectly attempting to invoke an unbound method of a class in this way is " "sometimes referred to as 'metaclass confusion', and is avoided by bypassing " "the instance when looking up special methods::" msgstr "" -#: ../../reference/datamodel.rst:2800 +#: ../../reference/datamodel.rst:2798 msgid "" "In addition to bypassing any instance attributes in the interest of " "correctness, implicit special method lookup generally also bypasses the :" "meth:`__getattribute__` method even of the object's metaclass::" msgstr "" -#: ../../reference/datamodel.rst:2826 +#: ../../reference/datamodel.rst:2824 msgid "" "Bypassing the :meth:`__getattribute__` machinery in this fashion provides " "significant scope for speed optimisations within the interpreter, at the " @@ -3234,44 +3227,44 @@ msgid "" "invoked by the interpreter)." msgstr "" -#: ../../reference/datamodel.rst:2837 +#: ../../reference/datamodel.rst:2835 msgid "Coroutines" msgstr "協程" -#: ../../reference/datamodel.rst:2841 +#: ../../reference/datamodel.rst:2839 msgid "Awaitable Objects" msgstr "" -#: ../../reference/datamodel.rst:2843 +#: ../../reference/datamodel.rst:2841 msgid "" "An :term:`awaitable` object generally implements an :meth:`__await__` " "method. :term:`Coroutine objects ` returned from :keyword:`async " "def` functions are awaitable." msgstr "" -#: ../../reference/datamodel.rst:2849 +#: ../../reference/datamodel.rst:2847 msgid "" "The :term:`generator iterator` objects returned from generators decorated " "with :func:`types.coroutine` or :func:`asyncio.coroutine` are also " "awaitable, but they do not implement :meth:`__await__`." msgstr "" -#: ../../reference/datamodel.rst:2855 +#: ../../reference/datamodel.rst:2853 msgid "" "Must return an :term:`iterator`. Should be used to implement :term:" "`awaitable` objects. For instance, :class:`asyncio.Future` implements this " "method to be compatible with the :keyword:`await` expression." msgstr "" -#: ../../reference/datamodel.rst:2861 +#: ../../reference/datamodel.rst:2859 msgid ":pep:`492` for additional information about awaitable objects." msgstr "" -#: ../../reference/datamodel.rst:2867 +#: ../../reference/datamodel.rst:2865 msgid "Coroutine Objects" msgstr "" -#: ../../reference/datamodel.rst:2869 +#: ../../reference/datamodel.rst:2867 msgid "" ":term:`Coroutine objects ` are :term:`awaitable` objects. A " "coroutine's execution can be controlled by calling :meth:`__await__` and " @@ -3282,18 +3275,18 @@ msgid "" "not directly raise unhandled :exc:`StopIteration` exceptions." msgstr "" -#: ../../reference/datamodel.rst:2877 +#: ../../reference/datamodel.rst:2875 msgid "" "Coroutines also have the methods listed below, which are analogous to those " "of generators (see :ref:`generator-methods`). However, unlike generators, " "coroutines do not directly support iteration." msgstr "" -#: ../../reference/datamodel.rst:2881 +#: ../../reference/datamodel.rst:2879 msgid "It is a :exc:`RuntimeError` to await on a coroutine more than once." msgstr "" -#: ../../reference/datamodel.rst:2887 +#: ../../reference/datamodel.rst:2885 msgid "" "Starts or resumes execution of the coroutine. If *value* is ``None``, this " "is equivalent to advancing the iterator returned by :meth:`__await__`. If " @@ -3303,7 +3296,7 @@ msgid "" "as when iterating over the :meth:`__await__` return value, described above." msgstr "" -#: ../../reference/datamodel.rst:2897 +#: ../../reference/datamodel.rst:2895 msgid "" "Raises the specified exception in the coroutine. This method delegates to " "the :meth:`~generator.throw` method of the iterator that caused the " @@ -3314,7 +3307,7 @@ msgid "" "caught in the coroutine, it propagates back to the caller." msgstr "" -#: ../../reference/datamodel.rst:2908 +#: ../../reference/datamodel.rst:2906 msgid "" "Causes the coroutine to clean itself up and exit. If the coroutine is " "suspended, this method first delegates to the :meth:`~generator.close` " @@ -3324,97 +3317,97 @@ msgid "" "is marked as having finished executing, even if it was never started." msgstr "" -#: ../../reference/datamodel.rst:2916 +#: ../../reference/datamodel.rst:2914 msgid "" "Coroutine objects are automatically closed using the above process when they " "are about to be destroyed." msgstr "" -#: ../../reference/datamodel.rst:2922 +#: ../../reference/datamodel.rst:2920 msgid "Asynchronous Iterators" msgstr "" -#: ../../reference/datamodel.rst:2924 +#: ../../reference/datamodel.rst:2922 msgid "" "An *asynchronous iterator* can call asynchronous code in its ``__anext__`` " "method." msgstr "" -#: ../../reference/datamodel.rst:2927 +#: ../../reference/datamodel.rst:2925 msgid "" "Asynchronous iterators can be used in an :keyword:`async for` statement." msgstr "" -#: ../../reference/datamodel.rst:2931 +#: ../../reference/datamodel.rst:2929 msgid "Must return an *asynchronous iterator* object." msgstr "" -#: ../../reference/datamodel.rst:2935 +#: ../../reference/datamodel.rst:2933 msgid "" "Must return an *awaitable* resulting in a next value of the iterator. " "Should raise a :exc:`StopAsyncIteration` error when the iteration is over." msgstr "" -#: ../../reference/datamodel.rst:2938 +#: ../../reference/datamodel.rst:2936 msgid "An example of an asynchronous iterable object::" msgstr "" -#: ../../reference/datamodel.rst:2955 +#: ../../reference/datamodel.rst:2953 msgid "" "Prior to Python 3.7, ``__aiter__`` could return an *awaitable* that would " "resolve to an :term:`asynchronous iterator `." msgstr "" -#: ../../reference/datamodel.rst:2960 +#: ../../reference/datamodel.rst:2958 msgid "" "Starting with Python 3.7, ``__aiter__`` must return an asynchronous iterator " "object. Returning anything else will result in a :exc:`TypeError` error." msgstr "" -#: ../../reference/datamodel.rst:2968 +#: ../../reference/datamodel.rst:2966 msgid "Asynchronous Context Managers" msgstr "" -#: ../../reference/datamodel.rst:2970 +#: ../../reference/datamodel.rst:2968 msgid "" "An *asynchronous context manager* is a *context manager* that is able to " "suspend execution in its ``__aenter__`` and ``__aexit__`` methods." msgstr "" -#: ../../reference/datamodel.rst:2973 +#: ../../reference/datamodel.rst:2971 msgid "" "Asynchronous context managers can be used in an :keyword:`async with` " "statement." msgstr "" -#: ../../reference/datamodel.rst:2977 +#: ../../reference/datamodel.rst:2975 msgid "" "Semantically similar to :meth:`__enter__`, the only difference being that it " "must return an *awaitable*." msgstr "" -#: ../../reference/datamodel.rst:2982 +#: ../../reference/datamodel.rst:2980 msgid "" "Semantically similar to :meth:`__exit__`, the only difference being that it " "must return an *awaitable*." msgstr "" -#: ../../reference/datamodel.rst:2985 +#: ../../reference/datamodel.rst:2983 msgid "An example of an asynchronous context manager class::" msgstr "" -#: ../../reference/datamodel.rst:2998 +#: ../../reference/datamodel.rst:2996 msgid "Footnotes" msgstr "註解" -#: ../../reference/datamodel.rst:2999 +#: ../../reference/datamodel.rst:2997 msgid "" "It *is* possible in some cases to change an object's type, under certain " "controlled conditions. It generally isn't a good idea though, since it can " "lead to some very strange behaviour if it is handled incorrectly." msgstr "" -#: ../../reference/datamodel.rst:3003 +#: ../../reference/datamodel.rst:3001 msgid "" "The :meth:`__hash__`, :meth:`__iter__`, :meth:`__reversed__`, and :meth:" "`__contains__` methods have special handling for this; others will still " @@ -3422,7 +3415,7 @@ msgid "" "``None`` is not callable." msgstr "" -#: ../../reference/datamodel.rst:3008 +#: ../../reference/datamodel.rst:3006 msgid "" "\"Does not support\" here means that the class has no such method, or the " "method returns ``NotImplemented``. Do not set the method to ``None`` if you " @@ -3430,7 +3423,7 @@ msgid "" "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" -#: ../../reference/datamodel.rst:3014 +#: ../../reference/datamodel.rst:3012 msgid "" "For operands of the same type, it is assumed that if the non-reflected " "method -- such as :meth:`__add__` -- fails then the overall operation is not "