mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-10 00:43:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 18

Issue #27720: Fix error in eng_to_decimal docs and add examples from the specification.

Browse source 
(Based on a first draft patch from Evelyn Mitchell.)
This commit is contained in:
Raymond Hettinger 2016-08-13 11:15:34 -07:00
parent bd664357f1
commit f6ffa9826e
2 changed files with 36 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

16
Doc/library/decimal.rst
View file

@ -836,11 +836,13 @@ Decimal objects
.. method:: to_eng_string(context=None)
Convert to an engineering-type string.
Convert to a string, using engineering notation if an exponent is needed.
Engineering notation has an exponent which is a multiple of 3, so there
are up to 3 digits left of the decimal place. For example, converts
``Decimal('123E+1')`` to ``Decimal('1.23E+3')``.
Engineering notation has an exponent which is a multiple of 3. This
can leave up to 3 digits to the left of the decimal place and may
require the addition of either one or two trailing zeros.
For example, this converts ``Decimal('123E+1')`` to ``Decimal('1.23E+3')``.
.. method:: to_integral(rounding=None, context=None)
@ -1410,7 +1412,11 @@ In addition to the three supplied contexts, new contexts can be created with the
.. method:: to_eng_string(x)
Converts a number to a string, using scientific notation.
Convert to a string, using engineering notation if an exponent is needed.
Engineering notation has an exponent which is a multiple of 3. This
can leave up to 3 digits to the left of the decimal place and may
require the addition of either one or two trailing zeros.
.. method:: to_integral_exact(x)