summaryrefslogtreecommitdiff
path: root/gsl-1.9/doc/specfunc-pow-int.texi
blob: f05469a5c9862960ef31b39fae5a98d88c53f3a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
@cindex power function
@cindex integer powers

The following functions are equivalent to the function @code{gsl_pow_int}
(@pxref{Small integer powers}) with an error estimate.  These functions are
declared in the header file @file{gsl_sf_pow_int.h}.

@deftypefun double gsl_sf_pow_int (double @var{x}, int @var{n})
@deftypefunx int gsl_sf_pow_int_e (double @var{x}, int @var{n}, gsl_sf_result * @var{result}) 
These routines compute the power @math{x^n} for integer @var{n}.  The
power is computed using the minimum number of multiplications. For
example, @math{x^8} is computed as @math{((x^2)^2)^2}, requiring only 3
multiplications.  For reasons of efficiency, these functions do not
check for overflow or underflow conditions.
@end deftypefun

@example
#include <gsl/gsl_sf_pow_int.h>
/* compute 3.0**12 */
double y = gsl_sf_pow_int(3.0, 12); 
@end example