[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 );
.sp
.BI "float complex clogf(float complex " z );
.sp
.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 );
	11	.sp
	12	.BI "float complex clogf(float complex " z );
	13	.sp
	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).
	20	The imaginary part of y is chosen in the interval [-pi,pi].
	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)