##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::atan2

From cppreference.com
< cpp‎ | numeric‎ | math

Defined in header `<cmath>` |  |
float atan2( float y, float x ); | (1) |
double atan2( double y, double x ); | (2) |
long double atan2( long double y, long double x ); | (3) |
Promoted atan2( Arithmetic1 y, Arithmetic2 x ); | (4) | (since C++11)

Computes the inverse tangent of `y/x` using the signs of arguments to correctly determine quadrant.

4) If any argument has integral type, it is cast to double. If any other argument is long double, then the return type is long double, otherwise it is double.

### [edit] Parameters

x, y | - | values of floating-point or integral types

### [edit] Return value

Arc tangent of `y/x` in radians in the range of `[-π; π]` radians.

Y argument
Return value
X argument

### [edit] Example

Run this code

    #include <cmath>
    #include <utility>
    #include <iostream>

    std::pair<double, double> cartesian_to_polar(double x, double y)
    {
        return {std::hypot(x, y), std::atan2(y,x)};
    }

    int main()
    {
        std::pair<double, double> polar = cartesian_to_polar(1, 1);
        std::cout << "(1,1) cartesian is (" << polar.first
                   << "," << polar.second<< ") polar\n";
    }

Output:

    (1,1) cartesian is (1.41421,0.785398) polar

### [edit] See also

atan | computes arc tangent (arctan(x)) (function) [edit]
asin | computes arc sine (arcsin(x)) (function) [edit]
acos | computes arc cosine (arccos(x)) (function) [edit]
tan | computes tangent (tan(x)) (function) [edit]
C documentation for atan2

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/numeric/math/atan2&oldid=67139"