cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : C Library : cmath (math.h) : atan
 
- -
C++
Information
Documentation
Reference
Articles
Sourcecode
Forum
Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
C Library
cassert (assert.h)
cctype (ctype.h)
cerrno (errno.h)
cfloat (float.h)
climits (limits.h)
clocale (locale.h)
cmath (math.h)
csetjmp (setjmp.h)
csignal (signal.h)
cstdarg (stdarg.h)
cstddef (stddef.h)
cstdio (stdio.h)
cstdlib (stdlib.h)
cstring (string.h)
ctime (time.h)
cmath (math.h)
functions:
· acos
· asin
· atan
· atan2
· ceil
· cos
· cosh
· exp
· fabs
· floor
· fmod
· frexp
· ldexp
· log
· log10
· modf
· pow
· sin
· sinh
· sqrt
· tan
· tanh
macro constants:
· HUGE_VAL

-

atan function
     double atan (      double x );
      float atan (       float x );
long double atan ( long double x );
<cmath>

Compute arc tangent

Returns the principal value of the arc tangent of x, expressed in radians.

In trigonometrics, arc tangent is the inverse operation of tangent.

Notice that because of the sign ambiguity, a function cannot determine with certainty in which quadrant the angle falls only by its tangent value. You can use atan2 if you need to determine the quadrant.

Parameters

x
Floating point value.

Return Value

Principal arc tangent of x, in the interval [-pi/2,+pi/2] radians.

Portability

In C, only the double version of this function exists with this name.

Example

/* atan example */
#include <stdio.h>
#include <math.h>

#define PI 3.14159265

int main ()
{
  double param, result;
  param = 1.0;
  result = atan (param) * 180 / PI;
  printf ("The arc tangent of %lf is %lf degrees\n", param, result );
  return 0;
}

Output:


The arc tangent of 1.000000 is 45.000000 degrees.

See also

atan2 Compute arc tangent with two parameters (function)
tan Compute tangent (function)
sin Compute sine (function)
cos Compute cosine (function)
© The C++ Resources Network, 2000-2007 - All rights reserved
Spotted an error? - contact us