From: Mark Dickinson Date: Thu, 21 Oct 2021 20:57:49 +0000 (+0100) Subject: bpo-44344: Document that pow can return a complex number for non-complex inputs.... X-Git-Tag: v3.11.0a2~113 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=887a55705bb6c05a507c2886c9978a9e0cff0dd7;p=thirdparty%2FPython%2Fcpython.git bpo-44344: Document that pow can return a complex number for non-complex inputs. (GH-27853) Co-authored-by: Łukasz Langa --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index a651d8829cd2..09211681baf3 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1346,7 +1346,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