original/man3/clog.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   4 .\" Distributed under GPL
   5 .\" %%%LICENSE_END
   6 .\"
   7 .TH CLOG 3 2008-08-11 "" "Linux Programmer's Manual"
   8 .SH NAME
   9 clog, clogf, clogl \- natural logarithm of a complex number
  10 .SH SYNOPSIS
  11 .B #include <complex.h>
  12 .sp
  13 .BI "double complex clog(double complex " z );
  14 .br
  15 .BI "float complex clogf(float complex " z );
  16 .br
  17 .BI "long double complex clogl(long double complex " z );
  18 .sp
  19 Link with \fI\-lm\fP.
  20 .SH DESCRIPTION
  21 The logarithm
  22 .BR clog ()
  23 is the inverse function of the exponential
  24 .BR cexp (3).
  25 Thus, if \fIy\ =\ clog(z)\fP, then \fIz\ =\ cexp(y)\fP.
  26 The imaginary part of
  27 .I y
  28 is chosen in the interval [\-pi,pi].
  29 .LP
  30 One has:
  31 .nf
  32
  33     clog(z) = log(cabs(z)) + I * carg(z)
  34 .fi
  35 .LP
  36 Note that
  37 .I z
  38 close to zero will cause an overflow.
  39 .SH VERSIONS
  40 These functions first appeared in glibc in version 2.1.
  41 .SH CONFORMING TO
  42 C99.
  43 .SH SEE ALSO
  44 .BR cabs (3),
  45 .BR cexp (3),
  46 .BR clog10 (3),
  47 .BR clog2 (3),
  48 .BR complex (7)
  49 .SH COLOPHON
  50 This page is part of release 3.68 of the Linux
  51 .I man-pages
  52 project.
  53 A description of the project,
  54 information about reporting bugs,
  55 and the latest version of this page,
  56 can be found at
  57 \%http://www.kernel.org/doc/man\-pages/.