[thirdparty/man-pages.git] / man3 / clog.3

.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\" Distributed under GPL
.\"
.TH CLOG 3 2002-07-28 "" "complex math routines"
.SH NAME
clog, clogf, clogl \- natural logarithm of a complex number
.SH SYNOPSIS
.B #include <complex.h>
.sp
.BI "double complex clog(double complex " z );
.br
.BI "float complex clogf(float complex " z );
.br
.BI "long double complex clogl(long double complex " z );
.sp
Link with \-lm.
.SH DESCRIPTION
The logarithm clog is the inverse function of the exponential cexp.
Thus, if y = clog(z), then z = cexp(y).
The imaginary part of y is chosen in the interval [\-pi,pi].
.LP
One has clog(z) = log(cabs(z))+I*carg(z).
.LP
Please note that z close to zero will cause an overflow. 
.SH "CONFORMING TO"
C99
.SH "SEE ALSO"
.BR cabs (3),
.BR cexp (3),
.BR clog10 (3),
.BR complex (5)
Commit	Line	Data
fea681da MK	1	.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
	2	.\" Distributed under GPL
	3	.\"
	4	.TH CLOG 3 2002-07-28 "" "complex math routines"
	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 );
d39541ec	11	.br
fea681da	12	.BI "float complex clogf(float complex " z );
d39541ec	13	.br
fea681da MK	14	.BI "long double complex clogl(long double complex " z );
	15	.sp
	16	Link with \-lm.
	17	.SH DESCRIPTION
	18	The logarithm clog is the inverse function of the exponential cexp.
	19	Thus, if y = clog(z), then z = cexp(y).
8c383102	20	The imaginary part of y is chosen in the interval [\-pi,pi].
fea681da MK	21	.LP
	22	One has clog(z) = log(cabs(z))+I*carg(z).
	23	.LP
	24	Please note that z close to zero will cause an overflow.
	25	.SH "CONFORMING TO"
	26	C99
	27	.SH "SEE ALSO"
	28	.BR cabs (3),
	29	.BR cexp (3),
	30	.BR clog10 (3),
	31	.BR complex (5)