overby.me
this repo has no description
1.\" Copyright (c) 2006 Apple Computer
2.\"
3.Dd December 11, 2006
4.Dt CLOG 3
5.Os BSD 4
6.Sh NAME
7.Nm clog
8.Nd complex logarithm function
9.Sh SYNOPSIS
10.Fd #include <complex.h>
11.Ft double complex
12.Fn clog "double complex z"
13.Ft long double complex
14.Fn clogl "long double complex z"
15.Ft float complex
16.Fn clogf "float complex z"
17.Sh DESCRIPTION
18.Fn clog "z"
19returns the complex logarithm of
20.Fa z .
21.Pp
22clog(conj(z)) = conj(clog(z)), for all complex floating-point numbers z.
23.Sh SPECIAL VALUES
24The conjugate symmetry of clog() is used to abbreviate the specification of special values.
25.Pp
26.Fn clog "-0 + 0i"
27returns -inf + Pi i and raises the divide-by-zero flag.
28.Pp
29.Fn clog "0 + 0i"
30returns -inf + 0i and raises the divide-by-zero flag.
31.Pp
32.Fn clog "x + inf i"
33returns inf + Pi/2 i, for finite x.
34.Pp
35.Fn clog "x + NaN i"
36returns NaN + NaN i.
37.Pp
38.Fn clog "-inf + yi"
39returns inf + Pi i, for finite positive y.
40.Pp
41.Fn clog "inf + yi"
42returns inf + 0i, for finite positive y.
43.Pp
44.Fn clog "-inf + inf i"
45returns inf + 3Pi/4 i.
46.Pp
47.Fn clog "inf + inf i"
48returns inf + Pi/4 i.
49.Pp
50.Fn clog "�inf + NaN i"
51returns inf + NaN i.
52.Pp
53.Fn clog "NaN + yi"
54returns NaN + NaN i, for finite y.
55.Pp
56.Fn clog "NaN + inf i"
57returns inf + NaN i.
58.Pp
59.Fn clog "NaN + NaN i"
60returns NaN + NaN i.
61.Pp
62.Sh NOTES
63.Sh SEE ALSO
64.Xr cexp 3
65.Xr log 3
66.Xr complex 3
67.Sh STANDARDS
68The
69.Fn clog
70function conforms to ISO/IEC 9899:1999(E).