original/man3/clog.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\"
   4 .TH CLOG 3 2008-08-11 "" "Linux Programmer's Manual"
   5 .SH NAME
   6 clog, clogf, clogl \- natural logarithm of a complex number
   7 .SH SYNOPSIS
   8 .B #include <complex.h>
   9 .sp
  10 .BI "double complex clog(double complex " z );
  11 .br
  12 .BI "float complex clogf(float complex " z );
  13 .br
  14 .BI "long double complex clogl(long double complex " z );
  15 .sp
  16 Link with \fI\-lm\fP.
  17 .SH DESCRIPTION
  18 The logarithm
  19 .BR clog ()
  20 is the inverse function of the exponential
  21 .BR cexp (3).
  22 Thus, if \fIy\ =\ clog(z)\fP, then \fIz\ =\ cexp(y)\fP.
  23 The imaginary part of
  24 .I y
  25 is chosen in the interval [\-pi,pi].
  26 .LP
  27 One has:
  28 .nf
  29
  30     clog(z) = log(cabs(z)) + I * carg(z)
  31 .fi
  32 .LP
  33 Note that
  34 .I z
  35 close to zero will cause an overflow.
  36 .SH VERSIONS
  37 These functions first appeared in glibc in version 2.1.
  38 .SH "CONFORMING TO"
  39 C99.
  40 .SH "SEE ALSO"
  41 .BR cabs (3),
  42 .BR cexp (3),
  43 .BR clog10 (3),
  44 .BR clog2 (3),
  45 .BR complex (7)