|
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