diff options
| author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2021-10-21 15:08:20 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-22 00:08:20 +0200 |
| commit | 9b3cda56870d087cf50f605e91f3d26964868640 (patch) | |
| tree | 03143ac3bf1945e643e07bdd61ef2b03316e9837 | |
| parent | 8fd7e8965d0ff9f76401b86aec2166cc59a40637 (diff) | |
| download | cpython-git-9b3cda56870d087cf50f605e91f3d26964868640.tar.gz | |
bpo-44344: Document that pow can return a complex number for non-complex inputs. (GH-27853) (GH-29135)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 887a55705bb6c05a507c2886c9978a9e0cff0dd7)
Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
| -rw-r--r-- | Doc/library/functions.rst | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index f4c3ef4600..689455409e 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1357,7 +1357,10 @@ are always available. They are listed here in alphabetical order. operands, the result has the same type as the operands (after coercion) unless the second argument is negative; in that case, all arguments are converted to float and a float result is delivered. For example, ``pow(10, 2)`` - returns ``100``, but ``pow(10, -2)`` returns ``0.01``. + returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative base of + type :class:`int` or :class:`float` and a non-integral exponent, a complex + result is delivered. For example, ``pow(-9, 0.5)`` returns a value close + to ``3j``. For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must also be of integer type and *mod* must be nonzero. If *mod* is present and |