|
1 | 1 | # -*- coding: utf-8 -*- |
2 | | -# Autogenerated by Sphinx on Tue Feb 6 21:21:08 2024 |
| 2 | +# Autogenerated by Sphinx on Tue Apr 2 09:24:48 2024 |
3 | 3 | # as part of the release process. |
4 | 4 | topics = {'assert': 'The "assert" statement\n' |
5 | 5 | '**********************\n' |
|
792 | 792 | '\n' |
793 | 793 | 'object.__dir__(self)\n' |
794 | 794 | '\n' |
795 | | - ' Called when "dir()" is called on the object. A ' |
796 | | - 'sequence must be\n' |
797 | | - ' returned. "dir()" converts the returned sequence to a ' |
| 795 | + ' Called when "dir()" is called on the object. An ' |
| 796 | + 'iterable must be\n' |
| 797 | + ' returned. "dir()" converts the returned iterable to a ' |
798 | 798 | 'list and\n' |
799 | 799 | ' sorts it.\n' |
800 | 800 | '\n' |
|
821 | 821 | 'returned.\n' |
822 | 822 | '\n' |
823 | 823 | 'The "__dir__" function should accept no arguments, and ' |
824 | | - 'return a\n' |
825 | | - 'sequence of strings that represents the names accessible ' |
| 824 | + 'return an\n' |
| 825 | + 'iterable of strings that represents the names accessible ' |
826 | 826 | 'on module. If\n' |
827 | 827 | 'present, this function overrides the standard "dir()" ' |
828 | 828 | 'search on a\n' |
|
4492 | 4492 | 'reflection,\n' |
4493 | 4493 | ' and "__eq__()" and "__ne__()" are their own reflection. ' |
4494 | 4494 | 'If the\n' |
4495 | | - ' operands are of different types, and right operand’s ' |
| 4495 | + ' operands are of different types, and the right operand’s ' |
4496 | 4496 | 'type is a\n' |
4497 | 4497 | ' direct or indirect subclass of the left operand’s type, ' |
4498 | 4498 | 'the\n' |
|
4502 | 4502 | 'is not\n' |
4503 | 4503 | ' considered.\n' |
4504 | 4504 | '\n' |
| 4505 | + ' When no appropriate method returns any value other than\n' |
| 4506 | + ' "NotImplemented", the "==" and "!=" operators will fall ' |
| 4507 | + 'back to\n' |
| 4508 | + ' "is" and "is not", respectively.\n' |
| 4509 | + '\n' |
4505 | 4510 | 'object.__hash__(self)\n' |
4506 | 4511 | '\n' |
4507 | 4512 | ' Called by built-in function "hash()" and for operations ' |
|
4957 | 4962 | 'the\n' |
4958 | 4963 | 'current directory, it is read with "\'utf-8\'" encoding and ' |
4959 | 4964 | 'executed as\n' |
4960 | | - 'if it had been typed at the debugger prompt. This is ' |
4961 | | - 'particularly\n' |
4962 | | - 'useful for aliases. If both files exist, the one in the home\n' |
4963 | | - 'directory is read first and aliases defined there can be ' |
4964 | | - 'overridden by\n' |
4965 | | - 'the local file.\n' |
4966 | | - '\n' |
4967 | | - 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" ' |
4968 | | - 'encoding.\n' |
4969 | | - 'Previously, it was read with the system locale encoding.\n' |
| 4965 | + 'if it had been typed at the debugger prompt, with the exception ' |
| 4966 | + 'that\n' |
| 4967 | + 'empty lines and lines starting with "#" are ignored. This is\n' |
| 4968 | + 'particularly useful for aliases. If both files exist, the one ' |
| 4969 | + 'in the\n' |
| 4970 | + 'home directory is read first and aliases defined there can be\n' |
| 4971 | + 'overridden by the local file.\n' |
4970 | 4972 | '\n' |
4971 | 4973 | 'Changed in version 3.2: ".pdbrc" can now contain commands that\n' |
4972 | 4974 | 'continue debugging, such as "continue" or "next". Previously, ' |
4973 | 4975 | 'these\n' |
4974 | 4976 | 'commands had no effect.\n' |
4975 | 4977 | '\n' |
| 4978 | + 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" ' |
| 4979 | + 'encoding.\n' |
| 4980 | + 'Previously, it was read with the system locale encoding.\n' |
| 4981 | + '\n' |
4976 | 4982 | 'h(elp) [command]\n' |
4977 | 4983 | '\n' |
4978 | 4984 | ' Without argument, print the list of available commands. With ' |
|
8110 | 8116 | '"__rsub__()"\n' |
8111 | 8117 | ' method, "type(y).__rsub__(y, x)" is called if ' |
8112 | 8118 | '"type(x).__sub__(x,\n' |
8113 | | - ' y)" returns *NotImplemented*.\n' |
| 8119 | + ' y)" returns "NotImplemented".\n' |
8114 | 8120 | '\n' |
8115 | 8121 | ' Note that ternary "pow()" will not try calling ' |
8116 | 8122 | '"__rpow__()" (the\n' |
|
8153 | 8159 | 'the result\n' |
8154 | 8160 | ' (which could be, but does not have to be, *self*). If a ' |
8155 | 8161 | 'specific\n' |
8156 | | - ' method is not defined, the augmented assignment falls ' |
8157 | | - 'back to the\n' |
8158 | | - ' normal methods. For instance, if *x* is an instance of ' |
8159 | | - 'a class\n' |
8160 | | - ' with an "__iadd__()" method, "x += y" is equivalent to ' |
8161 | | - '"x =\n' |
8162 | | - ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and ' |
8163 | | - '"y.__radd__(x)" are\n' |
| 8162 | + ' method is not defined, or if that method returns ' |
| 8163 | + '"NotImplemented",\n' |
| 8164 | + ' the augmented assignment falls back to the normal ' |
| 8165 | + 'methods. For\n' |
| 8166 | + ' instance, if *x* is an instance of a class with an ' |
| 8167 | + '"__iadd__()"\n' |
| 8168 | + ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . ' |
| 8169 | + 'If\n' |
| 8170 | + ' "__iadd__()" does not exist, or if "x.__iadd__(y)" ' |
| 8171 | + 'returns\n' |
| 8172 | + ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" ' |
| 8173 | + 'are\n' |
8164 | 8174 | ' considered, as with the evaluation of "x + y". In ' |
8165 | 8175 | 'certain\n' |
8166 | 8176 | ' situations, augmented assignment can result in ' |
|
8241 | 8251 | 'Every object has an identity, a type and a value. An object’s\n' |
8242 | 8252 | '*identity* never changes once it has been created; you may think ' |
8243 | 8253 | 'of it\n' |
8244 | | - 'as the object’s address in memory. The ‘"is"’ operator compares ' |
| 8254 | + 'as the object’s address in memory. The "is" operator compares ' |
8245 | 8255 | 'the\n' |
8246 | 8256 | 'identity of two objects; the "id()" function returns an integer\n' |
8247 | 8257 | 'representing its identity.\n' |
|
8306 | 8316 | 'Note that the use of the implementation’s tracing or debugging\n' |
8307 | 8317 | 'facilities may keep objects alive that would normally be ' |
8308 | 8318 | 'collectable.\n' |
8309 | | - 'Also note that catching an exception with a ‘"try"…"except"’ ' |
| 8319 | + 'Also note that catching an exception with a "try"…"except" ' |
8310 | 8320 | 'statement\n' |
8311 | 8321 | 'may keep objects alive.\n' |
8312 | 8322 | '\n' |
|
8321 | 8331 | 'release the external resource, usually a "close()" method. ' |
8322 | 8332 | 'Programs\n' |
8323 | 8333 | 'are strongly recommended to explicitly close such objects. The\n' |
8324 | | - '‘"try"…"finally"’ statement and the ‘"with"’ statement provide\n' |
8325 | | - 'convenient ways to do this.\n' |
| 8334 | + '"try"…"finally" statement and the "with" statement provide ' |
| 8335 | + 'convenient\n' |
| 8336 | + 'ways to do this.\n' |
8326 | 8337 | '\n' |
8327 | 8338 | 'Some objects contain references to other objects; these are ' |
8328 | 8339 | 'called\n' |
|
8699 | 8710 | 'The try statement.\n' |
8700 | 8711 | '\n' |
8701 | 8712 | 'Changed in version 3.3: "None" is now permitted as "Y" in "raise X\n' |
8702 | | - 'from Y".\n' |
8703 | | - '\n' |
8704 | | - 'New in version 3.3: The "__suppress_context__" attribute to ' |
8705 | | - 'suppress\n' |
| 8713 | + 'from Y".Added the "__suppress_context__" attribute to suppress\n' |
8706 | 8714 | 'automatic display of the exception context.\n' |
8707 | 8715 | '\n' |
8708 | 8716 | 'Changed in version 3.11: If the traceback of the active exception ' |
|
9479 | 9487 | 'reflection,\n' |
9480 | 9488 | ' and "__eq__()" and "__ne__()" are their own reflection. ' |
9481 | 9489 | 'If the\n' |
9482 | | - ' operands are of different types, and right operand’s type ' |
9483 | | - 'is a\n' |
| 9490 | + ' operands are of different types, and the right operand’s ' |
| 9491 | + 'type is a\n' |
9484 | 9492 | ' direct or indirect subclass of the left operand’s type, ' |
9485 | 9493 | 'the\n' |
9486 | 9494 | ' reflected method of the right operand has priority, ' |
|
9489 | 9497 | 'is not\n' |
9490 | 9498 | ' considered.\n' |
9491 | 9499 | '\n' |
| 9500 | + ' When no appropriate method returns any value other than\n' |
| 9501 | + ' "NotImplemented", the "==" and "!=" operators will fall ' |
| 9502 | + 'back to\n' |
| 9503 | + ' "is" and "is not", respectively.\n' |
| 9504 | + '\n' |
9492 | 9505 | 'object.__hash__(self)\n' |
9493 | 9506 | '\n' |
9494 | 9507 | ' Called by built-in function "hash()" and for operations ' |
|
9730 | 9743 | '\n' |
9731 | 9744 | 'object.__dir__(self)\n' |
9732 | 9745 | '\n' |
9733 | | - ' Called when "dir()" is called on the object. A sequence ' |
| 9746 | + ' Called when "dir()" is called on the object. An iterable ' |
9734 | 9747 | 'must be\n' |
9735 | | - ' returned. "dir()" converts the returned sequence to a ' |
| 9748 | + ' returned. "dir()" converts the returned iterable to a ' |
9736 | 9749 | 'list and\n' |
9737 | 9750 | ' sorts it.\n' |
9738 | 9751 | '\n' |
|
9759 | 9772 | 'returned.\n' |
9760 | 9773 | '\n' |
9761 | 9774 | 'The "__dir__" function should accept no arguments, and ' |
9762 | | - 'return a\n' |
9763 | | - 'sequence of strings that represents the names accessible on ' |
| 9775 | + 'return an\n' |
| 9776 | + 'iterable of strings that represents the names accessible on ' |
9764 | 9777 | 'module. If\n' |
9765 | 9778 | 'present, this function overrides the standard "dir()" search ' |
9766 | 9779 | 'on a\n' |
|
11023 | 11036 | '"__rsub__()"\n' |
11024 | 11037 | ' method, "type(y).__rsub__(y, x)" is called if ' |
11025 | 11038 | '"type(x).__sub__(x,\n' |
11026 | | - ' y)" returns *NotImplemented*.\n' |
| 11039 | + ' y)" returns "NotImplemented".\n' |
11027 | 11040 | '\n' |
11028 | 11041 | ' Note that ternary "pow()" will not try calling ' |
11029 | 11042 | '"__rpow__()" (the\n' |
@@ -11066,14 +11079,17 @@ |
11066 | 11079 | 'the result\n' |
11067 | 11080 | ' (which could be, but does not have to be, *self*). If a ' |
11068 | 11081 | 'specific\n' |
11069 | | - ' method is not defined, the augmented assignment falls ' |
11070 | | - 'back to the\n' |
11071 | | - ' normal methods. For instance, if *x* is an instance of a ' |
11072 | | - 'class\n' |
11073 | | - ' with an "__iadd__()" method, "x += y" is equivalent to "x ' |
11074 | | - '=\n' |
11075 | | - ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and ' |
11076 | | - '"y.__radd__(x)" are\n' |
| 11082 | + ' method is not defined, or if that method returns ' |
| 11083 | + '"NotImplemented",\n' |
| 11084 | + ' the augmented assignment falls back to the normal ' |
| 11085 | + 'methods. For\n' |
| 11086 | + ' instance, if *x* is an instance of a class with an ' |
| 11087 | + '"__iadd__()"\n' |
| 11088 | + ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . ' |
| 11089 | + 'If\n' |
| 11090 | + ' "__iadd__()" does not exist, or if "x.__iadd__(y)" ' |
| 11091 | + 'returns\n' |
| 11092 | + ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" are\n' |
11077 | 11093 | ' considered, as with the evaluation of "x + y". In ' |
11078 | 11094 | 'certain\n' |
11079 | 11095 | ' situations, augmented assignment can result in unexpected ' |
|
12356 | 12372 | '\n' |
12357 | 12373 | 'New in version 3.3: The "\'rb\'" prefix of raw bytes literals has ' |
12358 | 12374 | 'been\n' |
12359 | | - 'added as a synonym of "\'br\'".\n' |
12360 | | - '\n' |
12361 | | - 'New in version 3.3: Support for the unicode legacy literal\n' |
| 12375 | + 'added as a synonym of "\'br\'".Support for the unicode legacy ' |
| 12376 | + 'literal\n' |
12362 | 12377 | '("u\'value\'") was reintroduced to simplify the maintenance of ' |
12363 | 12378 | 'dual\n' |
12364 | 12379 | 'Python 2.x and 3.x codebases. See **PEP 414** for more ' |
@@ -13065,14 +13080,18 @@ |
13065 | 13080 | 'contains\n' |
13066 | 13081 | 'the numbers 0, 1, …, *n*-1. Item *i* of sequence *a* is selected ' |
13067 | 13082 | 'by\n' |
13068 | | - '"a[i]".\n' |
| 13083 | + '"a[i]". Some sequences, including built-in sequences, interpret\n' |
| 13084 | + 'negative subscripts by adding the sequence length. For example,\n' |
| 13085 | + '"a[-2]" equals "a[n-2]", the second to last item of sequence a ' |
| 13086 | + 'with\n' |
| 13087 | + 'length "n".\n' |
13069 | 13088 | '\n' |
13070 | 13089 | 'Sequences also support slicing: "a[i:j]" selects all items with ' |
13071 | 13090 | 'index\n' |
13072 | 13091 | '*k* such that *i* "<=" *k* "<" *j*. When used as an expression, a\n' |
13073 | | - 'slice is a sequence of the same type. This implies that the index ' |
13074 | | - 'set\n' |
13075 | | - 'is renumbered so that it starts at 0.\n' |
| 13092 | + 'slice is a sequence of the same type. The comment above about ' |
| 13093 | + 'negative\n' |
| 13094 | + 'indexes also applies to negative slice positions.\n' |
13076 | 13095 | '\n' |
13077 | 13096 | 'Some sequences also support “extended slicing” with a third “step”\n' |
13078 | 13097 | 'parameter: "a[i:j:k]" selects all items of *a* with index *x* where ' |
|
13809 | 13828 | 'name |\n' |
13810 | 13829 | '+----------------------------------------------------+----------------------------------------------------+\n' |
13811 | 13830 | '| codeobject.co_qualname | The fully ' |
13812 | | - 'qualified function name |\n' |
| 13831 | + 'qualified function name New in version |\n' |
| 13832 | + '| | ' |
| 13833 | + '3.11. |\n' |
13813 | 13834 | '+----------------------------------------------------+----------------------------------------------------+\n' |
13814 | 13835 | '| codeobject.co_argcount | The total ' |
13815 | 13836 | 'number of positional *parameters* |\n' |
|
14025 | 14046 | 'tools.\n' |
14026 | 14047 | ' The PEP that introduced the "co_lines()" method.\n' |
14027 | 14048 | '\n' |
| 14049 | + 'codeobject.replace(**kwargs)\n' |
| 14050 | + '\n' |
| 14051 | + ' Return a copy of the code object with new values for the ' |
| 14052 | + 'specified\n' |
| 14053 | + ' fields.\n' |
| 14054 | + '\n' |
| 14055 | + ' New in version 3.8.\n' |
| 14056 | + '\n' |
14028 | 14057 | '\n' |
14029 | 14058 | 'Frame objects\n' |
14030 | 14059 | '-------------\n' |
|
15570 | 15599 | 'objects\n' |
15571 | 15600 | 'based on the sequence of values they define (instead of ' |
15572 | 15601 | 'comparing\n' |
15573 | | - 'based on object identity).\n' |
15574 | | - '\n' |
15575 | | - 'New in version 3.3: The "start", "stop" and "step" attributes.\n' |
| 15602 | + 'based on object identity).Added the "start", "stop" and "step"\n' |
| 15603 | + 'attributes.\n' |
15576 | 15604 | '\n' |
15577 | 15605 | 'See also:\n' |
15578 | 15606 | '\n' |
|
0 commit comments