From: Georg Brandl Date: Tue, 21 Mar 2006 08:48:04 +0000 (+0000) Subject: Add a note about pow(x,y) equalling x**y (the "**" operator X-Git-Tag: v2.5a0~149 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=48b4bf7b1a0feae48df27d7ecb9fdde448ef432d;p=thirdparty%2FPython%2Fcpython.git Add a note about pow(x,y) equalling x**y (the "**" operator was used unmotivated in the pow() docs) --- diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index 9b6bfe9d7b4c..eeed877f945f 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -735,8 +735,11 @@ class C: \begin{funcdesc}{pow}{x, y\optional{, z}} Return \var{x} to the power \var{y}; if \var{z} is present, return \var{x} to the power \var{y}, modulo \var{z} (computed more - efficiently than \code{pow(\var{x}, \var{y}) \%\ \var{z}}). The - arguments must have numeric types. With mixed operand types, the + efficiently than \code{pow(\var{x}, \var{y}) \%\ \var{z}}). + The two-argument form \code{pow(\var{x}, \var{y})} is equivalent to using + the power operator: \code{\var{x}**\var{y}}. + + The arguments must have numeric types. With mixed operand types, the coercion rules for binary arithmetic operators apply. For int and long int operands, the result has the same type as the operands (after coercion) unless the second argument is negative; in that