|
1 | 1 | # -*- coding: utf-8 -*-
|
2 |
| -# Autogenerated by Sphinx on Thu Feb 15 14:30:52 2024 |
| 2 | +# Autogenerated by Sphinx on Tue Mar 12 18:35:04 2024 |
3 | 3 | # as part of the release process.
|
4 | 4 | topics = {'assert': 'The "assert" statement\n'
|
5 | 5 | '**********************\n'
|
|
4724 | 4724 | 'reflection,\n'
|
4725 | 4725 | ' and "__eq__()" and "__ne__()" are their own reflection. '
|
4726 | 4726 | 'If the\n'
|
4727 |
| - ' operands are of different types, and right operand’s ' |
| 4727 | + ' operands are of different types, and the right operand’s ' |
4728 | 4728 | 'type is a\n'
|
4729 | 4729 | ' direct or indirect subclass of the left operand’s type, '
|
4730 | 4730 | 'the\n'
|
|
4734 | 4734 | 'is not\n'
|
4735 | 4735 | ' considered.\n'
|
4736 | 4736 | '\n'
|
| 4737 | + ' When no appropriate method returns any value other than\n' |
| 4738 | + ' "NotImplemented", the "==" and "!=" operators will fall ' |
| 4739 | + 'back to\n' |
| 4740 | + ' "is" and "is not", respectively.\n' |
| 4741 | + '\n' |
4737 | 4742 | 'object.__hash__(self)\n'
|
4738 | 4743 | '\n'
|
4739 | 4744 | ' Called by built-in function "hash()" and for operations '
|
|
5223 | 5228 | 'overridden by\n'
|
5224 | 5229 | 'the local file.\n'
|
5225 | 5230 | '\n'
|
5226 |
| - 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" ' |
5227 |
| - 'encoding.\n' |
5228 |
| - 'Previously, it was read with the system locale encoding.\n' |
5229 |
| - '\n' |
5230 | 5231 | 'Changed in version 3.2: ".pdbrc" can now contain commands that\n'
|
5231 | 5232 | 'continue debugging, such as "continue" or "next". Previously, '
|
5232 | 5233 | 'these\n'
|
5233 | 5234 | 'commands had no effect.\n'
|
5234 | 5235 | '\n'
|
| 5236 | + 'Changed in version 3.11: ".pdbrc" is now read with "\'utf-8\'" ' |
| 5237 | + 'encoding.\n' |
| 5238 | + 'Previously, it was read with the system locale encoding.\n' |
| 5239 | + '\n' |
5235 | 5240 | 'h(elp) [command]\n'
|
5236 | 5241 | '\n'
|
5237 | 5242 | ' Without argument, print the list of available commands. With '
|
|
8756 | 8761 | '"__rsub__()"\n'
|
8757 | 8762 | ' method, "type(y).__rsub__(y, x)" is called if '
|
8758 | 8763 | '"type(x).__sub__(x,\n'
|
8759 |
| - ' y)" returns *NotImplemented*.\n' |
| 8764 | + ' y)" returns "NotImplemented".\n' |
8760 | 8765 | '\n'
|
8761 | 8766 | ' Note that ternary "pow()" will not try calling '
|
8762 | 8767 | '"__rpow__()" (the\n'
|
|
8799 | 8804 | 'the result\n'
|
8800 | 8805 | ' (which could be, but does not have to be, *self*). If a '
|
8801 | 8806 | 'specific\n'
|
8802 |
| - ' method is not defined, the augmented assignment falls ' |
8803 |
| - 'back to the\n' |
8804 |
| - ' normal methods. For instance, if *x* is an instance of ' |
8805 |
| - 'a class\n' |
8806 |
| - ' with an "__iadd__()" method, "x += y" is equivalent to ' |
8807 |
| - '"x =\n' |
8808 |
| - ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and ' |
8809 |
| - '"y.__radd__(x)" are\n' |
| 8807 | + ' method is not defined, or if that method returns ' |
| 8808 | + '"NotImplemented",\n' |
| 8809 | + ' the augmented assignment falls back to the normal ' |
| 8810 | + 'methods. For\n' |
| 8811 | + ' instance, if *x* is an instance of a class with an ' |
| 8812 | + '"__iadd__()"\n' |
| 8813 | + ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . ' |
| 8814 | + 'If\n' |
| 8815 | + ' "__iadd__()" does not exist, or if "x.__iadd__(y)" ' |
| 8816 | + 'returns\n' |
| 8817 | + ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" ' |
| 8818 | + 'are\n' |
8810 | 8819 | ' considered, as with the evaluation of "x + y". In '
|
8811 | 8820 | 'certain\n'
|
8812 | 8821 | ' situations, augmented assignment can result in '
|
|
8887 | 8896 | 'Every object has an identity, a type and a value. An object’s\n'
|
8888 | 8897 | '*identity* never changes once it has been created; you may think '
|
8889 | 8898 | 'of it\n'
|
8890 |
| - 'as the object’s address in memory. The ‘"is"’ operator compares ' |
| 8899 | + 'as the object’s address in memory. The "is" operator compares ' |
8891 | 8900 | 'the\n'
|
8892 | 8901 | 'identity of two objects; the "id()" function returns an integer\n'
|
8893 | 8902 | 'representing its identity.\n'
|
|
8952 | 8961 | 'Note that the use of the implementation’s tracing or debugging\n'
|
8953 | 8962 | 'facilities may keep objects alive that would normally be '
|
8954 | 8963 | 'collectable.\n'
|
8955 |
| - 'Also note that catching an exception with a ‘"try"…"except"’ ' |
| 8964 | + 'Also note that catching an exception with a "try"…"except" ' |
8956 | 8965 | 'statement\n'
|
8957 | 8966 | 'may keep objects alive.\n'
|
8958 | 8967 | '\n'
|
|
8967 | 8976 | 'release the external resource, usually a "close()" method. '
|
8968 | 8977 | 'Programs\n'
|
8969 | 8978 | 'are strongly recommended to explicitly close such objects. The\n'
|
8970 |
| - '‘"try"…"finally"’ statement and the ‘"with"’ statement provide\n' |
8971 |
| - 'convenient ways to do this.\n' |
| 8979 | + '"try"…"finally" statement and the "with" statement provide ' |
| 8980 | + 'convenient\n' |
| 8981 | + 'ways to do this.\n' |
8972 | 8982 | '\n'
|
8973 | 8983 | 'Some objects contain references to other objects; these are '
|
8974 | 8984 | 'called\n'
|
|
9345 | 9355 | 'The try statement.\n'
|
9346 | 9356 | '\n'
|
9347 | 9357 | 'Changed in version 3.3: "None" is now permitted as "Y" in "raise X\n'
|
9348 |
| - 'from Y".\n' |
9349 |
| - '\n' |
9350 |
| - 'New in version 3.3: The "__suppress_context__" attribute to ' |
9351 |
| - 'suppress\n' |
| 9358 | + 'from Y".Added the "__suppress_context__" attribute to suppress\n' |
9352 | 9359 | 'automatic display of the exception context.\n'
|
9353 | 9360 | '\n'
|
9354 | 9361 | 'Changed in version 3.11: If the traceback of the active exception '
|
|
10133 | 10140 | 'reflection,\n'
|
10134 | 10141 | ' and "__eq__()" and "__ne__()" are their own reflection. '
|
10135 | 10142 | 'If the\n'
|
10136 |
| - ' operands are of different types, and right operand’s type ' |
10137 |
| - 'is a\n' |
| 10143 | + ' operands are of different types, and the right operand’s ' |
| 10144 | + 'type is a\n' |
10138 | 10145 | ' direct or indirect subclass of the left operand’s type, '
|
10139 | 10146 | 'the\n'
|
10140 | 10147 | ' reflected method of the right operand has priority, '
|
|
10143 | 10150 | 'is not\n'
|
10144 | 10151 | ' considered.\n'
|
10145 | 10152 | '\n'
|
| 10153 | + ' When no appropriate method returns any value other than\n' |
| 10154 | + ' "NotImplemented", the "==" and "!=" operators will fall ' |
| 10155 | + 'back to\n' |
| 10156 | + ' "is" and "is not", respectively.\n' |
| 10157 | + '\n' |
10146 | 10158 | 'object.__hash__(self)\n'
|
10147 | 10159 | '\n'
|
10148 | 10160 | ' Called by built-in function "hash()" and for operations '
|
|
11682 | 11694 | '"__rsub__()"\n'
|
11683 | 11695 | ' method, "type(y).__rsub__(y, x)" is called if '
|
11684 | 11696 | '"type(x).__sub__(x,\n'
|
11685 |
| - ' y)" returns *NotImplemented*.\n' |
| 11697 | + ' y)" returns "NotImplemented".\n' |
11686 | 11698 | '\n'
|
11687 | 11699 | ' Note that ternary "pow()" will not try calling '
|
11688 | 11700 | '"__rpow__()" (the\n'
|
@@ -11725,14 +11737,17 @@
|
11725 | 11737 | 'the result\n'
|
11726 | 11738 | ' (which could be, but does not have to be, *self*). If a '
|
11727 | 11739 | 'specific\n'
|
11728 |
| - ' method is not defined, the augmented assignment falls ' |
11729 |
| - 'back to the\n' |
11730 |
| - ' normal methods. For instance, if *x* is an instance of a ' |
11731 |
| - 'class\n' |
11732 |
| - ' with an "__iadd__()" method, "x += y" is equivalent to "x ' |
11733 |
| - '=\n' |
11734 |
| - ' x.__iadd__(y)" . Otherwise, "x.__add__(y)" and ' |
11735 |
| - '"y.__radd__(x)" are\n' |
| 11740 | + ' method is not defined, or if that method returns ' |
| 11741 | + '"NotImplemented",\n' |
| 11742 | + ' the augmented assignment falls back to the normal ' |
| 11743 | + 'methods. For\n' |
| 11744 | + ' instance, if *x* is an instance of a class with an ' |
| 11745 | + '"__iadd__()"\n' |
| 11746 | + ' method, "x += y" is equivalent to "x = x.__iadd__(y)" . ' |
| 11747 | + 'If\n' |
| 11748 | + ' "__iadd__()" does not exist, or if "x.__iadd__(y)" ' |
| 11749 | + 'returns\n' |
| 11750 | + ' "NotImplemented", "x.__add__(y)" and "y.__radd__(x)" are\n' |
11736 | 11751 | ' considered, as with the evaluation of "x + y". In '
|
11737 | 11752 | 'certain\n'
|
11738 | 11753 | ' situations, augmented assignment can result in unexpected '
|
|
13080 | 13095 | '\n'
|
13081 | 13096 | 'New in version 3.3: The "\'rb\'" prefix of raw bytes literals has '
|
13082 | 13097 | 'been\n'
|
13083 |
| - 'added as a synonym of "\'br\'".\n' |
13084 |
| - '\n' |
13085 |
| - 'New in version 3.3: Support for the unicode legacy literal\n' |
| 13098 | + 'added as a synonym of "\'br\'".Support for the unicode legacy ' |
| 13099 | + 'literal\n' |
13086 | 13100 | '("u\'value\'") was reintroduced to simplify the maintenance of '
|
13087 | 13101 | 'dual\n'
|
13088 | 13102 | 'Python 2.x and 3.x codebases. See **PEP 414** for more '
|
|
14765 | 14779 | 'tools.\n'
|
14766 | 14780 | ' The PEP that introduced the "co_lines()" method.\n'
|
14767 | 14781 | '\n'
|
| 14782 | + 'codeobject.replace(**kwargs)\n' |
| 14783 | + '\n' |
| 14784 | + ' Return a copy of the code object with new values for the ' |
| 14785 | + 'specified\n' |
| 14786 | + ' fields.\n' |
| 14787 | + '\n' |
| 14788 | + ' Code objects are also supported by the generic function\n' |
| 14789 | + ' "copy.replace()".\n' |
| 14790 | + '\n' |
| 14791 | + ' New in version 3.8.\n' |
| 14792 | + '\n' |
14768 | 14793 | '\n'
|
14769 | 14794 | 'Frame objects\n'
|
14770 | 14795 | '-------------\n'
|
|
16109 | 16134 | '\n'
|
16110 | 16135 | ' For sorting examples and a brief sorting tutorial, see '
|
16111 | 16136 | 'Sorting\n'
|
16112 |
| - ' HOW TO.\n' |
| 16137 | + ' Techniques.\n' |
16113 | 16138 | '\n'
|
16114 | 16139 | ' **CPython implementation detail:** While a list is being '
|
16115 | 16140 | 'sorted,\n'
|
|
16324 | 16349 | 'objects\n'
|
16325 | 16350 | 'based on the sequence of values they define (instead of '
|
16326 | 16351 | 'comparing\n'
|
16327 |
| - 'based on object identity).\n' |
16328 |
| - '\n' |
16329 |
| - 'New in version 3.3: The "start", "stop" and "step" attributes.\n' |
| 16352 | + 'based on object identity).Added the "start", "stop" and "step"\n' |
| 16353 | + 'attributes.\n' |
16330 | 16354 | '\n'
|
16331 | 16355 | 'See also:\n'
|
16332 | 16356 | '\n'
|
|
0 commit comments