|
1 | 1 | # -*- coding: utf-8 -*- |
2 | | -# Autogenerated by Sphinx on Mon Feb 24 21:52:17 2020 |
| 2 | +# Autogenerated by Sphinx on Wed Apr 29 19:18:01 2020 |
3 | 3 | topics = {'assert': 'The "assert" statement\n' |
4 | 4 | '**********************\n' |
5 | 5 | '\n' |
|
1475 | 1475 | ' | starred_and_keywords ["," ' |
1476 | 1476 | 'keywords_arguments]\n' |
1477 | 1477 | ' | keywords_arguments\n' |
1478 | | - ' positional_arguments ::= ["*"] expression ("," ["*"] ' |
1479 | | - 'expression)*\n' |
| 1478 | + ' positional_arguments ::= positional_item ("," positional_item)*\n' |
| 1479 | + ' positional_item ::= assignment_expression | "*" expression\n' |
1480 | 1480 | ' starred_and_keywords ::= ("*" expression | keyword_item)\n' |
1481 | 1481 | ' ("," "*" expression | "," ' |
1482 | 1482 | 'keyword_item)*\n' |
|
1872 | 1872 | ' value is false. A counter-intuitive implication is that ' |
1873 | 1873 | 'not-a-number\n' |
1874 | 1874 | ' values are not equal to themselves. For example, if "x =\n' |
1875 | | - ' float(\'NaN\')", "3 < x", "x < 3", "x == x", "x != x" are ' |
1876 | | - 'all false.\n' |
1877 | | - ' This behavior is compliant with IEEE 754.\n' |
| 1875 | + ' float(\'NaN\')", "3 < x", "x < 3" and "x == x" are all ' |
| 1876 | + 'false, while "x\n' |
| 1877 | + ' != x" is true. This behavior is compliant with IEEE 754.\n' |
1878 | 1878 | '\n' |
1879 | 1879 | '* "None" and "NotImplemented" are singletons. **PEP 8** ' |
1880 | 1880 | 'advises\n' |
|
2186 | 2186 | '\n' |
2187 | 2187 | 'The "if" statement is used for conditional execution:\n' |
2188 | 2188 | '\n' |
2189 | | - ' if_stmt ::= "if" expression ":" suite\n' |
2190 | | - ' ("elif" expression ":" suite)*\n' |
| 2189 | + ' if_stmt ::= "if" assignment_expression ":" suite\n' |
| 2190 | + ' ("elif" assignment_expression ":" suite)*\n' |
2191 | 2191 | ' ["else" ":" suite]\n' |
2192 | 2192 | '\n' |
2193 | 2193 | 'It selects exactly one of the suites by evaluating the ' |
|
2210 | 2210 | 'an\n' |
2211 | 2211 | 'expression is true:\n' |
2212 | 2212 | '\n' |
2213 | | - ' while_stmt ::= "while" expression ":" suite\n' |
| 2213 | + ' while_stmt ::= "while" assignment_expression ":" suite\n' |
2214 | 2214 | ' ["else" ":" suite]\n' |
2215 | 2215 | '\n' |
2216 | 2216 | 'This repeatedly tests the expression and, if it is true, ' |
|
3136 | 3136 | '\n' |
3137 | 3137 | 'When a description of an arithmetic operator below uses the ' |
3138 | 3138 | 'phrase\n' |
3139 | | - '“the numeric arguments are converted to a common type,” this ' |
| 3139 | + '“the numeric arguments are converted to a common type”, this ' |
3140 | 3140 | 'means\n' |
3141 | 3141 | 'that the operator implementation for built-in types works as ' |
3142 | 3142 | 'follows:\n' |
|
4402 | 4402 | '\n' |
4403 | 4403 | 'The "if" statement is used for conditional execution:\n' |
4404 | 4404 | '\n' |
4405 | | - ' if_stmt ::= "if" expression ":" suite\n' |
4406 | | - ' ("elif" expression ":" suite)*\n' |
| 4405 | + ' if_stmt ::= "if" assignment_expression ":" suite\n' |
| 4406 | + ' ("elif" assignment_expression ":" suite)*\n' |
4407 | 4407 | ' ["else" ":" suite]\n' |
4408 | 4408 | '\n' |
4409 | 4409 | 'It selects exactly one of the suites by evaluating the expressions ' |
|
4819 | 4819 | '[","]\n' |
4820 | 4820 | ' starred_expression ::= expression | (starred_item ",")* ' |
4821 | 4821 | '[starred_item]\n' |
4822 | | - ' starred_item ::= expression | "*" or_expr\n' |
| 4822 | + ' starred_item ::= assignment_expression | "*" or_expr\n' |
4823 | 4823 | '\n' |
4824 | 4824 | 'Except when part of a list or set display, an expression list\n' |
4825 | 4825 | 'containing at least one comma yields a tuple. The length of ' |
|
5129 | 5129 | 'only\n' |
5130 | 5130 | 'supported by the numeric types.\n' |
5131 | 5131 | '\n' |
5132 | | - 'A general convention is that an empty format string ("""") ' |
| 5132 | + 'A general convention is that an empty format specification ' |
5133 | 5133 | 'produces\n' |
5134 | 5134 | 'the same result as if you had called "str()" on the value. ' |
5135 | 5135 | 'A non-empty\n' |
5136 | | - 'format string typically modifies the result.\n' |
| 5136 | + 'format specification typically modifies the result.\n' |
5137 | 5137 | '\n' |
5138 | 5138 | 'The general form of a *standard format specifier* is:\n' |
5139 | 5139 | '\n' |
|
5939 | 5939 | 'convention.\n' |
5940 | 5940 | '\n' |
5941 | 5941 | '"__*__"\n' |
5942 | | - ' System-defined names. These names are defined by the ' |
5943 | | - 'interpreter\n' |
5944 | | - ' and its implementation (including the standard library). ' |
5945 | | - 'Current\n' |
5946 | | - ' system names are discussed in the Special method names ' |
5947 | | - 'section and\n' |
5948 | | - ' elsewhere. More will likely be defined in future versions ' |
5949 | | - 'of\n' |
5950 | | - ' Python. *Any* use of "__*__" names, in any context, that ' |
5951 | | - 'does not\n' |
5952 | | - ' follow explicitly documented use, is subject to breakage ' |
5953 | | - 'without\n' |
5954 | | - ' warning.\n' |
| 5942 | + ' System-defined names, informally known as “dunder” names. ' |
| 5943 | + 'These\n' |
| 5944 | + ' names are defined by the interpreter and its ' |
| 5945 | + 'implementation\n' |
| 5946 | + ' (including the standard library). Current system names are\n' |
| 5947 | + ' discussed in the Special method names section and ' |
| 5948 | + 'elsewhere. More\n' |
| 5949 | + ' will likely be defined in future versions of Python. *Any* ' |
| 5950 | + 'use of\n' |
| 5951 | + ' "__*__" names, in any context, that does not follow ' |
| 5952 | + 'explicitly\n' |
| 5953 | + ' documented use, is subject to breakage without warning.\n' |
5955 | 5954 | '\n' |
5956 | 5955 | '"__*"\n' |
5957 | 5956 | ' Class-private names. Names in this category, when used ' |
|
6087 | 6086 | 'convention.\n' |
6088 | 6087 | '\n' |
6089 | 6088 | '"__*__"\n' |
6090 | | - ' System-defined names. These names are defined by the ' |
6091 | | - 'interpreter\n' |
6092 | | - ' and its implementation (including the standard library). ' |
6093 | | - 'Current\n' |
6094 | | - ' system names are discussed in the Special method names ' |
6095 | | - 'section and\n' |
6096 | | - ' elsewhere. More will likely be defined in future versions ' |
6097 | | - 'of\n' |
6098 | | - ' Python. *Any* use of "__*__" names, in any context, that ' |
6099 | | - 'does not\n' |
6100 | | - ' follow explicitly documented use, is subject to breakage ' |
6101 | | - 'without\n' |
6102 | | - ' warning.\n' |
| 6089 | + ' System-defined names, informally known as “dunder” names. ' |
| 6090 | + 'These\n' |
| 6091 | + ' names are defined by the interpreter and its ' |
| 6092 | + 'implementation\n' |
| 6093 | + ' (including the standard library). Current system names ' |
| 6094 | + 'are\n' |
| 6095 | + ' discussed in the Special method names section and ' |
| 6096 | + 'elsewhere. More\n' |
| 6097 | + ' will likely be defined in future versions of Python. ' |
| 6098 | + '*Any* use of\n' |
| 6099 | + ' "__*__" names, in any context, that does not follow ' |
| 6100 | + 'explicitly\n' |
| 6101 | + ' documented use, is subject to breakage without warning.\n' |
6103 | 6102 | '\n' |
6104 | 6103 | '"__*"\n' |
6105 | 6104 | ' Class-private names. Names in this category, when used ' |
|
6114 | 6113 | '\n' |
6115 | 6114 | 'The "if" statement is used for conditional execution:\n' |
6116 | 6115 | '\n' |
6117 | | - ' if_stmt ::= "if" expression ":" suite\n' |
6118 | | - ' ("elif" expression ":" suite)*\n' |
| 6116 | + ' if_stmt ::= "if" assignment_expression ":" suite\n' |
| 6117 | + ' ("elif" assignment_expression ":" suite)*\n' |
6119 | 6118 | ' ["else" ":" suite]\n' |
6120 | 6119 | '\n' |
6121 | 6120 | 'It selects exactly one of the suites by evaluating the expressions ' |
|
6984 | 6983 | 'program is represented by objects or by relations between ' |
6985 | 6984 | 'objects. (In\n' |
6986 | 6985 | 'a sense, and in conformance to Von Neumann’s model of a “stored\n' |
6987 | | - 'program computer,” code is also represented by objects.)\n' |
| 6986 | + 'program computer”, code is also represented by objects.)\n' |
6988 | 6987 | '\n' |
6989 | 6988 | 'Every object has an identity, a type and a value. An object’s\n' |
6990 | 6989 | '*identity* never changes once it has been created; you may think ' |
|
9012 | 9011 | '\n' |
9013 | 9012 | 'If the metaclass has no "__prepare__" attribute, then the ' |
9014 | 9013 | 'class\n' |
9015 | | - 'namespace is initialised as an empty "dict()".\n' |
| 9014 | + 'namespace is initialised as an empty ordered mapping.\n' |
9016 | 9015 | '\n' |
9017 | 9016 | 'See also:\n' |
9018 | 9017 | '\n' |
|
11432 | 11431 | ' then they can be used interchangeably to index the same\n' |
11433 | 11432 | ' dictionary entry.\n' |
11434 | 11433 | '\n' |
| 11434 | + ' Dictionaries preserve insertion order, meaning that keys will ' |
| 11435 | + 'be\n' |
| 11436 | + ' produced in the same order they were added sequentially over ' |
| 11437 | + 'the\n' |
| 11438 | + ' dictionary. Replacing an existing key does not change the ' |
| 11439 | + 'order,\n' |
| 11440 | + ' however removing a key and re-inserting it will add it to ' |
| 11441 | + 'the\n' |
| 11442 | + ' end instead of keeping its old place.\n' |
| 11443 | + '\n' |
11435 | 11444 | ' Dictionaries are mutable; they can be created by the "{...}"\n' |
11436 | 11445 | ' notation (see section Dictionary displays).\n' |
11437 | 11446 | '\n' |
|
11440 | 11449 | '"collections"\n' |
11441 | 11450 | ' module.\n' |
11442 | 11451 | '\n' |
| 11452 | + ' Changed in version 3.7: Dictionaries did not preserve ' |
| 11453 | + 'insertion\n' |
| 11454 | + ' order in versions of Python before 3.6. In CPython 3.6,\n' |
| 11455 | + ' insertion order was preserved, but it was considered an\n' |
| 11456 | + ' implementation detail at that time rather than a language\n' |
| 11457 | + ' guarantee.\n' |
| 11458 | + '\n' |
11443 | 11459 | 'Callable types\n' |
11444 | 11460 | ' These are the types to which the function call operation (see\n' |
11445 | 11461 | ' section Calls) can be applied:\n' |
|
13589 | 13605 | 'The "while" statement is used for repeated execution as long as an\n' |
13590 | 13606 | 'expression is true:\n' |
13591 | 13607 | '\n' |
13592 | | - ' while_stmt ::= "while" expression ":" suite\n' |
| 13608 | + ' while_stmt ::= "while" assignment_expression ":" suite\n' |
13593 | 13609 | ' ["else" ":" suite]\n' |
13594 | 13610 | '\n' |
13595 | 13611 | 'This repeatedly tests the expression and, if it is true, executes ' |
|
0 commit comments