Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

gh-92417: `fractions`, `decimal`: Improve docs for alternative constructor methods (GH-92421) 

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
This commit is contained in:
Alex Waygood 2022-05-19 16:28:51 +01:00 committed by GitHub
parent 639b62c9c4
commit 090df844ea
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
Doc/library/decimal.rst
View File

@ -571,9 +571,10 @@ Decimal objects
>>> Decimal(321).exp() >>> Decimal(321).exp()
Decimal('2.561702493119680037517373933E+139') Decimal('2.561702493119680037517373933E+139')
.. method:: from_float(f) .. classmethod:: from_float(f)
Classmethod that converts a float to a decimal number, exactly. Alternative constructor that only accepts instances of :class:`float` or
:class:`int`.
Note `Decimal.from_float(0.1)` is not the same as `Decimal('0.1')`. Note `Decimal.from_float(0.1)` is not the same as `Decimal('0.1')`.
Since 0.1 is not exactly representable in binary floating point, the Since 0.1 is not exactly representable in binary floating point, the

12
Doc/library/fractions.rst
View File

@ -114,10 +114,10 @@ another rational number, or from a string.
.. versionadded:: 3.8 .. versionadded:: 3.8
.. method:: from_float(flt) .. classmethod:: from_float(flt)
This class method constructs a :class:`Fraction` representing the exact Alternative constructor which only accepts instances of
value of *flt*, which must be a :class:`float`. Beware that :class:`float` or :class:`numbers.Integral`. Beware that
``Fraction.from_float(0.3)`` is not the same value as ``Fraction(3, 10)``. ``Fraction.from_float(0.3)`` is not the same value as ``Fraction(3, 10)``.
.. note:: .. note::
@ -126,10 +126,10 @@ another rational number, or from a string.
:class:`Fraction` instance directly from a :class:`float`. :class:`Fraction` instance directly from a :class:`float`.
.. method:: from_decimal(dec) .. classmethod:: from_decimal(dec)
This class method constructs a :class:`Fraction` representing the exact Alternative constructor which only accepts instances of
value of *dec*, which must be a :class:`decimal.Decimal` instance. :class:`decimal.Decimal` or :class:`numbers.Integral`.
.. note:: .. note::