Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
C Library
cassert (assert.h)
cctype (ctype.h)
cerrno (errno.h)
cfloat (float.h)
ciso646 (iso646.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:
abs
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


acos

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

Compute arc cosine

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

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

In C++, this function is overloaded in <valarray> (see valarray acos).

Parameters

x
Floating point value in the interval [-1,+1].
If the argument is out of this interval, a domain error occurs, setting the global variable errno to the value EDOM.

Return Value

Principal arc cosine of x, in the interval [0,pi] radians.

Portability

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

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
/* acos example */
#include <stdio.h>
#include <math.h>
#define PI 3.14159265
int main ()
{
  double param, result;
  param = 0.5;
  result = acos (param) * 180.0 / PI;
  printf ("The arc cosine of %lf is %lf degrees.\n", param, result );
  return 0;
}


Output:

The arc cosine of 0.500000 is 60.000000 degrees.

See also