|
1 | 1 | # -*- coding: utf-8 -*- |
2 | | -# Autogenerated by Sphinx on Mon Dec 7 15:10:25 2020 |
| 2 | +# Autogenerated by Sphinx on Mon Dec 21 17:22:46 2020 |
3 | 3 | topics = {'assert': 'The "assert" statement\n' |
4 | 4 | '**********************\n' |
5 | 5 | '\n' |
|
2376 | 2376 | 'compatible\n' |
2377 | 2377 | 'with an exception if it is the class or a base class of the ' |
2378 | 2378 | 'exception\n' |
2379 | | - 'object or a tuple containing an item compatible with the ' |
2380 | | - 'exception.\n' |
| 2379 | + 'object, or a tuple containing an item that is the class or a ' |
| 2380 | + 'base\n' |
| 2381 | + 'class of the exception object.\n' |
2381 | 2382 | '\n' |
2382 | 2383 | 'If no except clause matches the exception, the search for an ' |
2383 | 2384 | 'exception\n' |
|
5512 | 5513 | ' | | formats the result in either fixed-point ' |
5513 | 5514 | 'format or in |\n' |
5514 | 5515 | ' | | scientific notation, depending on its ' |
5515 | | - 'magnitude. The |\n' |
5516 | | - ' | | precise rules are as follows: suppose that ' |
5517 | | - 'the result |\n' |
| 5516 | + 'magnitude. A |\n' |
| 5517 | + ' | | precision of "0" is treated as equivalent ' |
| 5518 | + 'to a precision |\n' |
| 5519 | + ' | | of "1". The precise rules are as follows: ' |
| 5520 | + 'suppose that |\n' |
| 5521 | + ' | | the result formatted with presentation ' |
| 5522 | + 'type "\'e\'" and |\n' |
| 5523 | + ' | | precision "p-1" would have exponent ' |
| 5524 | + '"exp". Then, if "m <= |\n' |
| 5525 | + ' | | exp < p", where "m" is -4 for floats and ' |
| 5526 | + '-6 for |\n' |
| 5527 | + ' | | "Decimals", the number is formatted with ' |
| 5528 | + 'presentation type |\n' |
| 5529 | + ' | | "\'f\'" and precision "p-1-exp". ' |
| 5530 | + 'Otherwise, the number is |\n' |
5518 | 5531 | ' | | formatted with presentation type "\'e\'" ' |
5519 | | - 'and precision "p-1" |\n' |
5520 | | - ' | | would have exponent "exp". Then, if "m <= ' |
5521 | | - 'exp < p", where |\n' |
5522 | | - ' | | "m" is -4 for floats and -6 for ' |
5523 | | - '"Decimals", the number is |\n' |
5524 | | - ' | | formatted with presentation type "\'f\'" ' |
5525 | 5532 | 'and precision |\n' |
5526 | | - ' | | "p-1-exp". Otherwise, the number is ' |
5527 | | - 'formatted with |\n' |
5528 | | - ' | | presentation type "\'e\'" and precision ' |
5529 | | - '"p-1". In both cases |\n' |
5530 | | - ' | | insignificant trailing zeros are removed ' |
5531 | | - 'from the |\n' |
5532 | | - ' | | significand, and the decimal point is also ' |
5533 | | - 'removed if |\n' |
5534 | | - ' | | there are no remaining digits following ' |
5535 | | - 'it, unless the |\n' |
5536 | | - ' | | "\'#\'" option is used. Positive and ' |
5537 | | - 'negative infinity, |\n' |
5538 | | - ' | | positive and negative zero, and nans, are ' |
5539 | | - 'formatted as |\n' |
5540 | | - ' | | "inf", "-inf", "0", "-0" and "nan" ' |
5541 | | - 'respectively, |\n' |
5542 | | - ' | | regardless of the precision. A precision ' |
5543 | | - 'of "0" is |\n' |
5544 | | - ' | | treated as equivalent to a precision of ' |
5545 | | - '"1". With no |\n' |
5546 | | - ' | | precision given, uses a precision of "6" ' |
5547 | | - 'significant |\n' |
5548 | | - ' | | digits for "float", and shows all ' |
5549 | | - 'coefficient digits for |\n' |
5550 | | - ' | | ' |
5551 | | - '"Decimal". ' |
5552 | | - '|\n' |
| 5533 | + ' | | "p-1". In both cases insignificant ' |
| 5534 | + 'trailing zeros are |\n' |
| 5535 | + ' | | removed from the significand, and the ' |
| 5536 | + 'decimal point is |\n' |
| 5537 | + ' | | also removed if there are no remaining ' |
| 5538 | + 'digits following |\n' |
| 5539 | + ' | | it, unless the "\'#\'" option is used. ' |
| 5540 | + 'With no precision |\n' |
| 5541 | + ' | | given, uses a precision of "6" significant ' |
| 5542 | + 'digits for |\n' |
| 5543 | + ' | | "float". For "Decimal", the coefficient of ' |
| 5544 | + 'the result is |\n' |
| 5545 | + ' | | formed from the coefficient digits of the ' |
| 5546 | + 'value; |\n' |
| 5547 | + ' | | scientific notation is used for values ' |
| 5548 | + 'smaller than "1e-6" |\n' |
| 5549 | + ' | | in absolute value and values where the ' |
| 5550 | + 'place value of the |\n' |
| 5551 | + ' | | least significant digit is larger than 1, ' |
| 5552 | + 'and fixed-point |\n' |
| 5553 | + ' | | notation is used otherwise. Positive and ' |
| 5554 | + 'negative |\n' |
| 5555 | + ' | | infinity, positive and negative zero, and ' |
| 5556 | + 'nans, are |\n' |
| 5557 | + ' | | formatted as "inf", "-inf", "0", "-0" and ' |
| 5558 | + '"nan" |\n' |
| 5559 | + ' | | respectively, regardless of the ' |
| 5560 | + 'precision. |\n' |
5553 | 5561 | ' ' |
5554 | 5562 | '+-----------+------------------------------------------------------------+\n' |
5555 | 5563 | ' | "\'G\'" | General format. Same as "\'g\'" except ' |
|
5574 | 5582 | 'percent sign. |\n' |
5575 | 5583 | ' ' |
5576 | 5584 | '+-----------+------------------------------------------------------------+\n' |
5577 | | - ' | None | Similar to "\'g\'", except that ' |
5578 | | - 'fixed-point notation, when |\n' |
5579 | | - ' | | used, has at least one digit past the ' |
5580 | | - 'decimal point. The |\n' |
5581 | | - ' | | default precision is as high as needed to ' |
5582 | | - 'represent the |\n' |
5583 | | - ' | | particular value. The overall effect is to ' |
5584 | | - 'match the |\n' |
5585 | | - ' | | output of "str()" as altered by the other ' |
5586 | | - 'format |\n' |
5587 | | - ' | | ' |
5588 | | - 'modifiers. ' |
5589 | | - '|\n' |
| 5585 | + ' | None | For "float" this is the same as "\'g\'", ' |
| 5586 | + 'except that when |\n' |
| 5587 | + ' | | fixed-point notation is used to format the ' |
| 5588 | + 'result, it |\n' |
| 5589 | + ' | | always includes at least one digit past ' |
| 5590 | + 'the decimal point. |\n' |
| 5591 | + ' | | The precision used is as large as needed ' |
| 5592 | + 'to represent the |\n' |
| 5593 | + ' | | given value faithfully. For "Decimal", ' |
| 5594 | + 'this is the same |\n' |
| 5595 | + ' | | as either "\'g\'" or "\'G\'" depending on ' |
| 5596 | + 'the value of |\n' |
| 5597 | + ' | | "context.capitals" for the current decimal ' |
| 5598 | + 'context. The |\n' |
| 5599 | + ' | | overall effect is to match the output of ' |
| 5600 | + '"str()" as |\n' |
| 5601 | + ' | | altered by the other format ' |
| 5602 | + 'modifiers. |\n' |
5590 | 5603 | ' ' |
5591 | 5604 | '+-----------+------------------------------------------------------------+\n' |
5592 | 5605 | '\n' |
|
11159 | 11172 | 'object is “compatible” with the exception. An object is compatible\n' |
11160 | 11173 | 'with an exception if it is the class or a base class of the ' |
11161 | 11174 | 'exception\n' |
11162 | | - 'object or a tuple containing an item compatible with the exception.\n' |
| 11175 | + 'object, or a tuple containing an item that is the class or a base\n' |
| 11176 | + 'class of the exception object.\n' |
11163 | 11177 | '\n' |
11164 | 11178 | 'If no except clause matches the exception, the search for an ' |
11165 | 11179 | 'exception\n' |
|
11340 | 11354 | 'representation\n' |
11341 | 11355 | ' in computers.\n' |
11342 | 11356 | '\n' |
11343 | | - ' The string representations of the Numeric classes, computed by\n' |
| 11357 | + ' The string representations of the numeric classes, computed by\n' |
11344 | 11358 | ' "__repr__()" and "__str__()", have the following properties:\n' |
11345 | 11359 | '\n' |
11346 | 11360 | ' * They are valid numeric literals which, when passed to their ' |
|
0 commit comments