Namespaces
Variants
Views
Actions

std::pow

From cppreference.com
< cpp‎ | numeric‎ | math
Revision as of 19:16, 21 June 2013 by P12 (Talk | contribs)

 
 
 
Common mathematical functions
Functions
Basic operations
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
Exponential functions
(C++11)
(C++11)
(C++11)
(C++11)
Power functions
(C++11)
(C++11)
pow
Trigonometric and hyperbolic functions
(C++11)
(C++11)
(C++11)
Error and gamma functions
(C++11)
(C++11)
(C++11)
(C++11)
Nearest integer floating point operations
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
Floating point manipulation functions
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
Classification/Comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Macro constants
(C++11)(C++11)(C++11)(C++11)(C++11)
 
Defined in header <cmath>
float       pow( float base, float exp );
(1)
double      pow( double base, double exp );
(2)
long double pow( long double base, long double exp );
(3)
float       pow( float base, int iexp );
(4) (until C++11)
double      pow( double base, int iexp );
(5) (until C++11)
long double pow( long double base, int iexp );
(6) (until C++11)
Promoted    pow( Arithmetic base, Arithmetic exp );
(7) (since C++11)

Computes the value of base raised to the power exp or iexp.

7) A set of overloads or a function template for all combinations of arguments of arithmetic type not covered by 1-3). If any argument has integral type, it is cast to double. If any argument is long double, then the return type Promoted is also long double, otherwise the return type is always double.

Contents

Parameters

base - base as floating point value
exp - exponent as floating point value
iexp - exponent as integer value

Return value

base raised by power (exp or iexp).

Domain error occurs if base is 0 and exp is less than or equal to 0. NAN is returned in that case.

Domain error occurs if base is negative and exp is not an integer value. NAN is returned in that case.

Range error occurs if an overflow takes place. HUGEVAL is returned in that case.

Notes

pow(float, int) returns float until C++11 (per overload 4) but returns double since C++11 (per overload 7)

See also

returns e raised to the given power (ex)
(function) [edit]
computes natural (base e) logarithm (to base e) (ln(x))
(function) [edit]
computes square root (x)
(function) [edit]
(C++11)
computes cubic root (3x)
(function) [edit]
complex power, one or both arguments may be a complex number
(function template) [edit]
applies the function std::pow to two valarrays or a valarray and a value
(function template) [edit]