original/man3/cacos.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\"
   4 .TH CACOS 3 2008-08-11 "" "Linux Programmer's Manual"
   5 .SH NAME
   6 cacos, cacosf, cacosl \- complex arc cosine
   7 .SH SYNOPSIS
   8 .B #include <complex.h>
   9 .sp
  10 .BI "double complex cacos(double complex " z );
  11 .br
  12 .BI "float complex cacosf(float complex " z );
  13 .br
  14 .BI "long double complex cacosl(long double complex " z );
  15 .sp
  16 Link with \fI\-lm\fP.
  17 .SH DESCRIPTION
  18 The
  19 .BR cacos ()
  20 function calculates the complex arc cosine of
  21 .IR z .
  22 If \fIy\ =\ cacos(z)\fP, then \fIz\ =\ ccos(y)\fP.
  23 The real part of
  24 .I y
  25 is chosen in the interval [0,pi].
  26 .LP
  27 One has:
  28 .nf
  29
  30     cacos(z) = \-i clog(z + csqrt(z * z \- 1))
  31 .fi
  32 .SH VERSIONS
  33 These functions first appeared in glibc in version 2.1.
  34 .SH "CONFORMING TO"
  35 C99.
  36 .SH "SEE ALSO"
  37 .BR ccos (3),
  38 .BR clog (3),
  39 .BR complex (7)