Clarify description of three-argument pow for Decimal types: the exponent of the result is always 0.

This commit is contained in:
Mark Dickinson 2010-02-22 15:40:28 +00:00
parent dfd0148909
commit f5be4e612c
1 changed files with 6 additions and 3 deletions

View File

@ -1321,9 +1321,12 @@ In addition to the three supplied contexts, new contexts can be created with the
- at least one of ``x`` or ``y`` must be nonzero
- ``modulo`` must be nonzero and have at most 'precision' digits
The result of ``Context.power(x, y, modulo)`` is identical to the result
that would be obtained by computing ``(x**y) % modulo`` with unbounded
precision, but is computed more efficiently. It is always exact.
The value resulting from ``Context.power(x, y, modulo)`` is
equal to the value that would be obtained by computing ``(x**y)
% modulo`` with unbounded precision, but is computed more
efficiently. The exponent of the result is zero, regardless of
the exponents of ``x``, ``y`` and ``modulo``. The result is
always exact.
.. versionchanged:: 2.6
``y`` may now be nonintegral in ``x**y``.