original/man3/cacosh.3

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