|
1 | 1 | # -*- coding: utf-8 -*- |
2 | | -# Autogenerated by Sphinx on Mon Dec 7 15:00:07 2020 |
| 2 | +# Autogenerated by Sphinx on Tue Feb 16 21:03:59 2021 |
3 | 3 | topics = {'assert': 'The "assert" statement\n' |
4 | 4 | '**********************\n' |
5 | 5 | '\n' |
|
459 | 459 | '\n' |
460 | 460 | ' async_for_stmt ::= "async" for_stmt\n' |
461 | 461 | '\n' |
462 | | - 'An *asynchronous iterable* is able to call asynchronous code in ' |
463 | | - 'its\n' |
464 | | - '*iter* implementation, and *asynchronous iterator* can call\n' |
465 | | - 'asynchronous code in its *next* method.\n' |
| 462 | + 'An *asynchronous iterable* provides an "__aiter__" method that\n' |
| 463 | + 'directly returns an *asynchronous iterator*, which can call\n' |
| 464 | + 'asynchronous code in its "__anext__" method.\n' |
466 | 465 | '\n' |
467 | 466 | 'The "async for" statement allows convenient iteration over\n' |
468 | | - 'asynchronous iterators.\n' |
| 467 | + 'asynchronous iterables.\n' |
469 | 468 | '\n' |
470 | 469 | 'The following code:\n' |
471 | 470 | '\n' |
|
2381 | 2380 | 'compatible\n' |
2382 | 2381 | 'with an exception if it is the class or a base class of the ' |
2383 | 2382 | 'exception\n' |
2384 | | - 'object or a tuple containing an item compatible with the ' |
2385 | | - 'exception.\n' |
| 2383 | + 'object, or a tuple containing an item that is the class or a ' |
| 2384 | + 'base\n' |
| 2385 | + 'class of the exception object.\n' |
2386 | 2386 | '\n' |
2387 | 2387 | 'If no except clause matches the exception, the search for an ' |
2388 | 2388 | 'exception\n' |
|
2991 | 2991 | '\n' |
2992 | 2992 | ' async_for_stmt ::= "async" for_stmt\n' |
2993 | 2993 | '\n' |
2994 | | - 'An *asynchronous iterable* is able to call asynchronous code in ' |
2995 | | - 'its\n' |
2996 | | - '*iter* implementation, and *asynchronous iterator* can call\n' |
2997 | | - 'asynchronous code in its *next* method.\n' |
| 2994 | + 'An *asynchronous iterable* provides an "__aiter__" method that\n' |
| 2995 | + 'directly returns an *asynchronous iterator*, which can call\n' |
| 2996 | + 'asynchronous code in its "__anext__" method.\n' |
2998 | 2997 | '\n' |
2999 | 2998 | 'The "async for" statement allows convenient iteration over\n' |
3000 | | - 'asynchronous iterators.\n' |
| 2999 | + 'asynchronous iterables.\n' |
3001 | 3000 | '\n' |
3002 | 3001 | 'The following code:\n' |
3003 | 3002 | '\n' |
|
5530 | 5529 | ' | | formats the result in either fixed-point ' |
5531 | 5530 | 'format or in |\n' |
5532 | 5531 | ' | | scientific notation, depending on its ' |
5533 | | - 'magnitude. The |\n' |
5534 | | - ' | | precise rules are as follows: suppose that ' |
5535 | | - 'the result |\n' |
| 5532 | + 'magnitude. A |\n' |
| 5533 | + ' | | precision of "0" is treated as equivalent ' |
| 5534 | + 'to a precision |\n' |
| 5535 | + ' | | of "1". The precise rules are as follows: ' |
| 5536 | + 'suppose that |\n' |
| 5537 | + ' | | the result formatted with presentation ' |
| 5538 | + 'type "\'e\'" and |\n' |
| 5539 | + ' | | precision "p-1" would have exponent ' |
| 5540 | + '"exp". Then, if "m <= |\n' |
| 5541 | + ' | | exp < p", where "m" is -4 for floats and ' |
| 5542 | + '-6 for |\n' |
| 5543 | + ' | | "Decimals", the number is formatted with ' |
| 5544 | + 'presentation type |\n' |
| 5545 | + ' | | "\'f\'" and precision "p-1-exp". ' |
| 5546 | + 'Otherwise, the number is |\n' |
5536 | 5547 | ' | | formatted with presentation type "\'e\'" ' |
5537 | | - 'and precision "p-1" |\n' |
5538 | | - ' | | would have exponent "exp". Then, if "m <= ' |
5539 | | - 'exp < p", where |\n' |
5540 | | - ' | | "m" is -4 for floats and -6 for ' |
5541 | | - '"Decimals", the number is |\n' |
5542 | | - ' | | formatted with presentation type "\'f\'" ' |
5543 | 5548 | 'and precision |\n' |
5544 | | - ' | | "p-1-exp". Otherwise, the number is ' |
5545 | | - 'formatted with |\n' |
5546 | | - ' | | presentation type "\'e\'" and precision ' |
5547 | | - '"p-1". In both cases |\n' |
5548 | | - ' | | insignificant trailing zeros are removed ' |
5549 | | - 'from the |\n' |
5550 | | - ' | | significand, and the decimal point is also ' |
5551 | | - 'removed if |\n' |
5552 | | - ' | | there are no remaining digits following ' |
5553 | | - 'it, unless the |\n' |
5554 | | - ' | | "\'#\'" option is used. Positive and ' |
5555 | | - 'negative infinity, |\n' |
5556 | | - ' | | positive and negative zero, and nans, are ' |
5557 | | - 'formatted as |\n' |
5558 | | - ' | | "inf", "-inf", "0", "-0" and "nan" ' |
5559 | | - 'respectively, |\n' |
5560 | | - ' | | regardless of the precision. A precision ' |
5561 | | - 'of "0" is |\n' |
5562 | | - ' | | treated as equivalent to a precision of ' |
5563 | | - '"1". With no |\n' |
5564 | | - ' | | precision given, uses a precision of "6" ' |
5565 | | - 'significant |\n' |
5566 | | - ' | | digits for "float", and shows all ' |
5567 | | - 'coefficient digits for |\n' |
5568 | | - ' | | ' |
5569 | | - '"Decimal". ' |
5570 | | - '|\n' |
| 5549 | + ' | | "p-1". In both cases insignificant ' |
| 5550 | + 'trailing zeros are |\n' |
| 5551 | + ' | | removed from the significand, and the ' |
| 5552 | + 'decimal point is |\n' |
| 5553 | + ' | | also removed if there are no remaining ' |
| 5554 | + 'digits following |\n' |
| 5555 | + ' | | it, unless the "\'#\'" option is used. ' |
| 5556 | + 'With no precision |\n' |
| 5557 | + ' | | given, uses a precision of "6" significant ' |
| 5558 | + 'digits for |\n' |
| 5559 | + ' | | "float". For "Decimal", the coefficient of ' |
| 5560 | + 'the result is |\n' |
| 5561 | + ' | | formed from the coefficient digits of the ' |
| 5562 | + 'value; |\n' |
| 5563 | + ' | | scientific notation is used for values ' |
| 5564 | + 'smaller than "1e-6" |\n' |
| 5565 | + ' | | in absolute value and values where the ' |
| 5566 | + 'place value of the |\n' |
| 5567 | + ' | | least significant digit is larger than 1, ' |
| 5568 | + 'and fixed-point |\n' |
| 5569 | + ' | | notation is used otherwise. Positive and ' |
| 5570 | + 'negative |\n' |
| 5571 | + ' | | infinity, positive and negative zero, and ' |
| 5572 | + 'nans, are |\n' |
| 5573 | + ' | | formatted as "inf", "-inf", "0", "-0" and ' |
| 5574 | + '"nan" |\n' |
| 5575 | + ' | | respectively, regardless of the ' |
| 5576 | + 'precision. |\n' |
5571 | 5577 | ' ' |
5572 | 5578 | '+-----------+------------------------------------------------------------+\n' |
5573 | 5579 | ' | "\'G\'" | General format. Same as "\'g\'" except ' |
|
5592 | 5598 | 'percent sign. |\n' |
5593 | 5599 | ' ' |
5594 | 5600 | '+-----------+------------------------------------------------------------+\n' |
5595 | | - ' | None | Similar to "\'g\'", except that ' |
5596 | | - 'fixed-point notation, when |\n' |
5597 | | - ' | | used, has at least one digit past the ' |
5598 | | - 'decimal point. The |\n' |
5599 | | - ' | | default precision is as high as needed to ' |
5600 | | - 'represent the |\n' |
5601 | | - ' | | particular value. The overall effect is to ' |
5602 | | - 'match the |\n' |
5603 | | - ' | | output of "str()" as altered by the other ' |
5604 | | - 'format |\n' |
5605 | | - ' | | ' |
5606 | | - 'modifiers. ' |
5607 | | - '|\n' |
| 5601 | + ' | None | For "float" this is the same as "\'g\'", ' |
| 5602 | + 'except that when |\n' |
| 5603 | + ' | | fixed-point notation is used to format the ' |
| 5604 | + 'result, it |\n' |
| 5605 | + ' | | always includes at least one digit past ' |
| 5606 | + 'the decimal point. |\n' |
| 5607 | + ' | | The precision used is as large as needed ' |
| 5608 | + 'to represent the |\n' |
| 5609 | + ' | | given value faithfully. For "Decimal", ' |
| 5610 | + 'this is the same |\n' |
| 5611 | + ' | | as either "\'g\'" or "\'G\'" depending on ' |
| 5612 | + 'the value of |\n' |
| 5613 | + ' | | "context.capitals" for the current decimal ' |
| 5614 | + 'context. The |\n' |
| 5615 | + ' | | overall effect is to match the output of ' |
| 5616 | + '"str()" as |\n' |
| 5617 | + ' | | altered by the other format ' |
| 5618 | + 'modifiers. |\n' |
5608 | 5619 | ' ' |
5609 | 5620 | '+-----------+------------------------------------------------------------+\n' |
5610 | 5621 | '\n' |
|
7950 | 7961 | 'immediate\n' |
7951 | 7962 | ' subclasses. This method returns a list of all those ' |
7952 | 7963 | 'references\n' |
7953 | | - ' still alive. Example:\n' |
| 7964 | + ' still alive. The list is in definition order. Example:\n' |
7954 | 7965 | '\n' |
7955 | 7966 | ' >>> int.__subclasses__()\n' |
7956 | 7967 | " [<class 'bool'>]\n" |
|
11259 | 11270 | 'object is “compatible” with the exception. An object is compatible\n' |
11260 | 11271 | 'with an exception if it is the class or a base class of the ' |
11261 | 11272 | 'exception\n' |
11262 | | - 'object or a tuple containing an item compatible with the exception.\n' |
| 11273 | + 'object, or a tuple containing an item that is the class or a base\n' |
| 11274 | + 'class of the exception object.\n' |
11263 | 11275 | '\n' |
11264 | 11276 | 'If no except clause matches the exception, the search for an ' |
11265 | 11277 | 'exception\n' |
|
11480 | 11492 | ' There are two types of integers:\n' |
11481 | 11493 | '\n' |
11482 | 11494 | ' Integers ("int")\n' |
11483 | | - '\n' |
11484 | 11495 | ' These represent numbers in an unlimited range, subject to\n' |
11485 | 11496 | ' available (virtual) memory only. For the purpose of ' |
11486 | 11497 | 'shift\n' |
|
0 commit comments