function template
<complex>
std::polar
template<class T> complex<T> polar (const T& rho, const T& theta = 0);
Complex from polar components
Returns a complex object (in cartesian format) corresponding to the complex number defined by its polar components rho and theta, where rho is the magnitude (modulus) and theta is the phase angle. The values in the return value are the same as if:
1 2
|
real = rho * cos(theta);
imag = rho * sin(theta);
|
Parameters
- rho
- Magnitude (modulus) of the complex number.
- theta
- Phase angle (angular component) of the complex number.
T is the type of the components of the complex type (i.e., its value type).
Return value
The complex cartesian equivalent to the polar format formed by rho and theta.
Example
1 2 3 4 5 6 7 8 9 10 11 12
|
// polar example
#include <iostream> // std::cout
#include <complex> // std::complex, std::polar
int main ()
{
std::cout << "The complex whose magnitude is " << 2.0;
std::cout << " and phase angle is " << 0.5;
std::cout << " is " << std::polar (2.0, 0.5) << '\n';
return 0;
}
|
Output:
The complex whose magnitude is 2 and phase angle is 0.5 is (1.75517,0.958851)
|
See also
- abs
- Absolute value of complex (function template)
- arg
- Phase angle of complex (function template)