mirror of
https://github.com/python/cpython.git
synced 2025-08-07 02:18:59 +00:00
Python 3.12.3
This commit is contained in:
Thomas Wouters
parent
ced359855e
commit
f6650f9ad7
109 changed files with 1218 additions and 330 deletions
|
|
@ -1,5 +1,5 @@
|
|||
# -*- coding: utf-8 -*-
|
||||
# Autogenerated by Sphinx on Tue Feb 6 21:16:37 2024
|
||||
# Autogenerated by Sphinx on Tue Apr 9 09:17:41 2024
|
||||
# as part of the release process.
|
||||
topics = {'assert': 'The "assert" statement\n'
|
||||
'**********************\n'
|
||||
|
|
@ -722,9 +722,9 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'\n'
|
||||
'object.__dir__(self)\n'
|
||||
'\n'
|
||||
' Called when "dir()" is called on the object. A '
|
||||
'sequence must be\n'
|
||||
' returned. "dir()" converts the returned sequence to a '
|
||||
' Called when "dir()" is called on the object. An '
|
||||
'iterable must be\n'
|
||||
' returned. "dir()" converts the returned iterable to a '
|
||||
'list and\n'
|
||||
' sorts it.\n'
|
||||
'\n'
|
||||
|
|
@ -751,8 +751,8 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'returned.\n'
|
||||
'\n'
|
||||
'The "__dir__" function should accept no arguments, and '
|
||||
'return a\n'
|
||||
'sequence of strings that represents the names accessible '
|
||||
'return an\n'
|
||||
'iterable of strings that represents the names accessible '
|
||||
'on module. If\n'
|
||||
'present, this function overrides the standard "dir()" '
|
||||
'search on a\n'
|
||||
|
|
@ -4724,7 +4724,7 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'reflection,\n'
|
||||
' and "__eq__()" and "__ne__()" are their own reflection. '
|
||||
'If the\n'
|
||||
' operands are of different types, and right operand’s '
|
||||
' operands are of different types, and the right operand’s '
|
||||
'type is a\n'
|
||||
' direct or indirect subclass of the left operand’s type, '
|
||||
'the\n'
|
||||
|
|
@ -4734,6 +4734,11 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'is not\n'
|
||||
' considered.\n'
|
||||
'\n'
|
||||
' When no appropriate method returns any value other than\n'
|
||||
' "NotImplemented", the "==" and "!=" operators will fall '
|
||||
'back to\n'
|
||||
' "is" and "is not", respectively.\n'
|
||||
'\n'
|
||||
'object.__hash__(self)\n'
|
||||
'\n'
|
||||
' Called by built-in function "hash()" and for operations '
|
||||
|
|
@ -5212,22 +5217,23 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'the\n'
|
||||
'current directory, it is read with "\'utf-8\'" encoding and '
|
||||
'executed as\n'
|
||||
'if it had been typed at the debugger prompt. This is '
|
||||
'particularly\n'
|
||||
'useful for aliases. If both files exist, the one in the home\n'
|
||||
'directory is read first and aliases defined there can be '
|
||||
'overridden by\n'
|
||||
'the local file.\n'
|
||||
'\n'
|
||||
'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" '
|
||||
'encoding.\n'
|
||||
'Previously, it was read with the system locale encoding.\n'
|
||||
'if it had been typed at the debugger prompt, with the exception '
|
||||
'that\n'
|
||||
'empty lines and lines starting with "#" are ignored. This is\n'
|
||||
'particularly useful for aliases. If both files exist, the one '
|
||||
'in the\n'
|
||||
'home directory is read first and aliases defined there can be\n'
|
||||
'overridden by the local file.\n'
|
||||
'\n'
|
||||
'Changed in version 3.2: ".pdbrc" can now contain commands that\n'
|
||||
'continue debugging, such as "continue" or "next". Previously, '
|
||||
'these\n'
|
||||
'commands had no effect.\n'
|
||||
'\n'
|
||||
'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" '
|
||||
'encoding.\n'
|
||||
'Previously, it was read with the system locale encoding.\n'
|
||||
'\n'
|
||||
'h(elp) [command]\n'
|
||||
'\n'
|
||||
' Without argument, print the list of available commands. With '
|
||||
|
|
@ -8559,32 +8565,36 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'\n'
|
||||
' nonlocal_stmt ::= "nonlocal" identifier ("," identifier)*\n'
|
||||
'\n'
|
||||
'The "nonlocal" statement causes the listed identifiers to refer '
|
||||
'to\n'
|
||||
'previously bound variables in the nearest enclosing scope '
|
||||
'excluding\n'
|
||||
'globals. This is important because the default behavior for '
|
||||
'binding is\n'
|
||||
'to search the local namespace first. The statement allows\n'
|
||||
'encapsulated code to rebind variables outside of the local '
|
||||
'scope\n'
|
||||
'besides the global (module) scope.\n'
|
||||
'When the definition of a function or class is nested (enclosed) '
|
||||
'within\n'
|
||||
'the definitions of other functions, its nonlocal scopes are the '
|
||||
'local\n'
|
||||
'scopes of the enclosing functions. The "nonlocal" statement '
|
||||
'causes the\n'
|
||||
'listed identifiers to refer to names previously bound in '
|
||||
'nonlocal\n'
|
||||
'scopes. It allows encapsulated code to rebind such nonlocal\n'
|
||||
'identifiers. If a name is bound in more than one nonlocal '
|
||||
'scope, the\n'
|
||||
'nearest binding is used. If a name is not bound in any nonlocal '
|
||||
'scope,\n'
|
||||
'or if there is no nonlocal scope, a "SyntaxError" is raised.\n'
|
||||
'\n'
|
||||
'Names listed in a "nonlocal" statement, unlike those listed in '
|
||||
'a\n'
|
||||
'"global" statement, must refer to pre-existing bindings in an\n'
|
||||
'enclosing scope (the scope in which a new binding should be '
|
||||
'created\n'
|
||||
'cannot be determined unambiguously).\n'
|
||||
'\n'
|
||||
'Names listed in a "nonlocal" statement must not collide with '
|
||||
'pre-\n'
|
||||
'existing bindings in the local scope.\n'
|
||||
'The nonlocal statement applies to the entire scope of a function '
|
||||
'or\n'
|
||||
'class body. A "SyntaxError" is raised if a variable is used or\n'
|
||||
'assigned to prior to its nonlocal declaration in the scope.\n'
|
||||
'\n'
|
||||
'See also:\n'
|
||||
'\n'
|
||||
' **PEP 3104** - Access to Names in Outer Scopes\n'
|
||||
' The specification for the "nonlocal" statement.\n',
|
||||
' The specification for the "nonlocal" statement.\n'
|
||||
'\n'
|
||||
'**Programmer’s note:** "nonlocal" is a directive to the parser '
|
||||
'and\n'
|
||||
'applies only to code parsed along with it. See the note for '
|
||||
'the\n'
|
||||
'"global" statement.\n',
|
||||
'numbers': 'Numeric literals\n'
|
||||
'****************\n'
|
||||
'\n'
|
||||
|
|
@ -8680,7 +8690,7 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'"__rsub__()"\n'
|
||||
' method, "type(y).__rsub__(y, x)" is called if '
|
||||
'"type(x).__sub__(x,\n'
|
||||
' y)" returns *NotImplemented*.\n'
|
||||
' y)" returns "NotImplemented".\n'
|
||||
'\n'
|
||||
' Note that ternary "pow()" will not try calling '
|
||||
'"__rpow__()" (the\n'
|
||||
|
|
@ -8723,14 +8733,18 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'the result\n'
|
||||
' (which could be, but does not have to be, *self*). If a '
|
||||
'specific\n'
|
||||
' method is not defined, the augmented assignment falls '
|
||||
'back to the\n'
|
||||
' normal methods. For instance, if *x* is an instance of '
|
||||
'a class\n'
|
||||
' with an "__iadd__()" method, "x += y" is equivalent to '
|
||||
'"x =\n'
|
||||
' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and '
|
||||
'"y.__radd__(x)" are\n'
|
||||
' method is not defined, or if that method returns '
|
||||
'"NotImplemented",\n'
|
||||
' the augmented assignment falls back to the normal '
|
||||
'methods. For\n'
|
||||
' instance, if *x* is an instance of a class with an '
|
||||
'"__iadd__()"\n'
|
||||
' method, "x += y" is equivalent to "x = x.__iadd__(y)" . '
|
||||
'If\n'
|
||||
' "__iadd__()" does not exist, or if "x.__iadd__(y)" '
|
||||
'returns\n'
|
||||
' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" '
|
||||
'are\n'
|
||||
' considered, as with the evaluation of "x + y". In '
|
||||
'certain\n'
|
||||
' situations, augmented assignment can result in '
|
||||
|
|
@ -8811,7 +8825,7 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'Every object has an identity, a type and a value. An object’s\n'
|
||||
'*identity* never changes once it has been created; you may think '
|
||||
'of it\n'
|
||||
'as the object’s address in memory. The ‘"is"’ operator compares '
|
||||
'as the object’s address in memory. The "is" operator compares '
|
||||
'the\n'
|
||||
'identity of two objects; the "id()" function returns an integer\n'
|
||||
'representing its identity.\n'
|
||||
|
|
@ -8876,7 +8890,7 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'Note that the use of the implementation’s tracing or debugging\n'
|
||||
'facilities may keep objects alive that would normally be '
|
||||
'collectable.\n'
|
||||
'Also note that catching an exception with a ‘"try"…"except"’ '
|
||||
'Also note that catching an exception with a "try"…"except" '
|
||||
'statement\n'
|
||||
'may keep objects alive.\n'
|
||||
'\n'
|
||||
|
|
@ -8891,8 +8905,9 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'release the external resource, usually a "close()" method. '
|
||||
'Programs\n'
|
||||
'are strongly recommended to explicitly close such objects. The\n'
|
||||
'‘"try"…"finally"’ statement and the ‘"with"’ statement provide\n'
|
||||
'convenient ways to do this.\n'
|
||||
'"try"…"finally" statement and the "with" statement provide '
|
||||
'convenient\n'
|
||||
'ways to do this.\n'
|
||||
'\n'
|
||||
'Some objects contain references to other objects; these are '
|
||||
'called\n'
|
||||
|
|
@ -9269,10 +9284,7 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'The try statement.\n'
|
||||
'\n'
|
||||
'Changed in version 3.3: "None" is now permitted as "Y" in "raise X\n'
|
||||
'from Y".\n'
|
||||
'\n'
|
||||
'New in version 3.3: The "__suppress_context__" attribute to '
|
||||
'suppress\n'
|
||||
'from Y".Added the "__suppress_context__" attribute to suppress\n'
|
||||
'automatic display of the exception context.\n'
|
||||
'\n'
|
||||
'Changed in version 3.11: If the traceback of the active exception '
|
||||
|
|
@ -10057,8 +10069,8 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'reflection,\n'
|
||||
' and "__eq__()" and "__ne__()" are their own reflection. '
|
||||
'If the\n'
|
||||
' operands are of different types, and right operand’s type '
|
||||
'is a\n'
|
||||
' operands are of different types, and the right operand’s '
|
||||
'type is a\n'
|
||||
' direct or indirect subclass of the left operand’s type, '
|
||||
'the\n'
|
||||
' reflected method of the right operand has priority, '
|
||||
|
|
@ -10067,6 +10079,11 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'is not\n'
|
||||
' considered.\n'
|
||||
'\n'
|
||||
' When no appropriate method returns any value other than\n'
|
||||
' "NotImplemented", the "==" and "!=" operators will fall '
|
||||
'back to\n'
|
||||
' "is" and "is not", respectively.\n'
|
||||
'\n'
|
||||
'object.__hash__(self)\n'
|
||||
'\n'
|
||||
' Called by built-in function "hash()" and for operations '
|
||||
|
|
@ -10308,9 +10325,9 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'\n'
|
||||
'object.__dir__(self)\n'
|
||||
'\n'
|
||||
' Called when "dir()" is called on the object. A sequence '
|
||||
' Called when "dir()" is called on the object. An iterable '
|
||||
'must be\n'
|
||||
' returned. "dir()" converts the returned sequence to a '
|
||||
' returned. "dir()" converts the returned iterable to a '
|
||||
'list and\n'
|
||||
' sorts it.\n'
|
||||
'\n'
|
||||
|
|
@ -10337,8 +10354,8 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'returned.\n'
|
||||
'\n'
|
||||
'The "__dir__" function should accept no arguments, and '
|
||||
'return a\n'
|
||||
'sequence of strings that represents the names accessible on '
|
||||
'return an\n'
|
||||
'iterable of strings that represents the names accessible on '
|
||||
'module. If\n'
|
||||
'present, this function overrides the standard "dir()" search '
|
||||
'on a\n'
|
||||
|
|
@ -11606,7 +11623,7 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'"__rsub__()"\n'
|
||||
' method, "type(y).__rsub__(y, x)" is called if '
|
||||
'"type(x).__sub__(x,\n'
|
||||
' y)" returns *NotImplemented*.\n'
|
||||
' y)" returns "NotImplemented".\n'
|
||||
'\n'
|
||||
' Note that ternary "pow()" will not try calling '
|
||||
'"__rpow__()" (the\n'
|
||||
|
|
@ -11649,14 +11666,17 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'the result\n'
|
||||
' (which could be, but does not have to be, *self*). If a '
|
||||
'specific\n'
|
||||
' method is not defined, the augmented assignment falls '
|
||||
'back to the\n'
|
||||
' normal methods. For instance, if *x* is an instance of a '
|
||||
'class\n'
|
||||
' with an "__iadd__()" method, "x += y" is equivalent to "x '
|
||||
'=\n'
|
||||
' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and '
|
||||
'"y.__radd__(x)" are\n'
|
||||
' method is not defined, or if that method returns '
|
||||
'"NotImplemented",\n'
|
||||
' the augmented assignment falls back to the normal '
|
||||
'methods. For\n'
|
||||
' instance, if *x* is an instance of a class with an '
|
||||
'"__iadd__()"\n'
|
||||
' method, "x += y" is equivalent to "x = x.__iadd__(y)" . '
|
||||
'If\n'
|
||||
' "__iadd__()" does not exist, or if "x.__iadd__(y)" '
|
||||
'returns\n'
|
||||
' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" are\n'
|
||||
' considered, as with the evaluation of "x + y". In '
|
||||
'certain\n'
|
||||
' situations, augmented assignment can result in unexpected '
|
||||
|
|
@ -12998,9 +13018,8 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'\n'
|
||||
'New in version 3.3: The "\'rb\'" prefix of raw bytes literals has '
|
||||
'been\n'
|
||||
'added as a synonym of "\'br\'".\n'
|
||||
'\n'
|
||||
'New in version 3.3: Support for the unicode legacy literal\n'
|
||||
'added as a synonym of "\'br\'".Support for the unicode legacy '
|
||||
'literal\n'
|
||||
'("u\'value\'") was reintroduced to simplify the maintenance of '
|
||||
'dual\n'
|
||||
'Python 2.x and 3.x codebases. See **PEP 414** for more '
|
||||
|
|
@ -13709,14 +13728,18 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'contains\n'
|
||||
'the numbers 0, 1, …, *n*-1. Item *i* of sequence *a* is selected '
|
||||
'by\n'
|
||||
'"a[i]".\n'
|
||||
'"a[i]". Some sequences, including built-in sequences, interpret\n'
|
||||
'negative subscripts by adding the sequence length. For example,\n'
|
||||
'"a[-2]" equals "a[n-2]", the second to last item of sequence a '
|
||||
'with\n'
|
||||
'length "n".\n'
|
||||
'\n'
|
||||
'Sequences also support slicing: "a[i:j]" selects all items with '
|
||||
'index\n'
|
||||
'*k* such that *i* "<=" *k* "<" *j*. When used as an expression, a\n'
|
||||
'slice is a sequence of the same type. This implies that the index '
|
||||
'set\n'
|
||||
'is renumbered so that it starts at 0.\n'
|
||||
'slice is a sequence of the same type. The comment above about '
|
||||
'negative\n'
|
||||
'indexes also applies to negative slice positions.\n'
|
||||
'\n'
|
||||
'Some sequences also support “extended slicing” with a third “step”\n'
|
||||
'parameter: "a[i:j:k]" selects all items of *a* with index *x* where '
|
||||
|
|
@ -14461,7 +14484,9 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'name |\n'
|
||||
'+----------------------------------------------------+----------------------------------------------------+\n'
|
||||
'| codeobject.co_qualname | The fully '
|
||||
'qualified function name |\n'
|
||||
'qualified function name New in version |\n'
|
||||
'| | '
|
||||
'3.11. |\n'
|
||||
'+----------------------------------------------------+----------------------------------------------------+\n'
|
||||
'| codeobject.co_argcount | The total '
|
||||
'number of positional *parameters* |\n'
|
||||
|
|
@ -14681,6 +14706,14 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'tools.\n'
|
||||
' The PEP that introduced the "co_lines()" method.\n'
|
||||
'\n'
|
||||
'codeobject.replace(**kwargs)\n'
|
||||
'\n'
|
||||
' Return a copy of the code object with new values for the '
|
||||
'specified\n'
|
||||
' fields.\n'
|
||||
'\n'
|
||||
' New in version 3.8.\n'
|
||||
'\n'
|
||||
'\n'
|
||||
'Frame objects\n'
|
||||
'-------------\n'
|
||||
|
|
@ -16019,7 +16052,7 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'\n'
|
||||
' For sorting examples and a brief sorting tutorial, see '
|
||||
'Sorting\n'
|
||||
' HOW TO.\n'
|
||||
' Techniques.\n'
|
||||
'\n'
|
||||
' **CPython implementation detail:** While a list is being '
|
||||
'sorted,\n'
|
||||
|
|
@ -16234,9 +16267,8 @@ topics = {'assert': 'The "assert" statement\n'
|
|||
'objects\n'
|
||||
'based on the sequence of values they define (instead of '
|
||||
'comparing\n'
|
||||
'based on object identity).\n'
|
||||
'\n'
|
||||
'New in version 3.3: The "start", "stop" and "step" attributes.\n'
|
||||
'based on object identity).Added the "start", "stop" and "step"\n'
|
||||
'attributes.\n'
|
||||
'\n'
|
||||
'See also:\n'
|
||||
'\n'
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue