Changes: Ready for 5.13
[man-pages.git] / man3 / clog10.3
blob47a18fcad2ad4b1be244311c44892a4f5567c8b5
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 CLOG10 3 2021-03-22 "" "Linux Programmer's Manual"
8 .SH NAME
9 clog10, clog10f, clog10l \- base-10 logarithm of a complex number
10 .SH SYNOPSIS
11 .nf
12 .BR "#define _GNU_SOURCE" "         /* See feature_test_macros(7) */"
13 .B #include <complex.h>
14 .PP
15 .BI "double complex clog10(double complex " z );
16 .BI "float complex clog10f(float complex " z );
17 .BI "long double complex clog10l(long double complex " z );
18 .PP
19 Link with \fI\-lm\fP.
20 .fi
21 .SH DESCRIPTION
22 The call
23 .I clog10(z)
24 is equivalent to:
25 .PP
26     clog(z)/log(10)
27 .PP
28 or equally:
29 .PP
30     log10(cabs(c)) + I * carg(c) / log(10)
31 .PP
32 The other functions perform the same task for
33 .I float
34 and
35 .IR "long double" .
36 .PP
37 Note that
38 .I z
39 close to zero will cause an overflow.
40 .SH VERSIONS
41 These functions first appeared in glibc in version 2.1.
42 .SH ATTRIBUTES
43 For an explanation of the terms used in this section, see
44 .BR attributes (7).
45 .ad l
46 .nh
47 .TS
48 allbox;
49 lbx lb lb
50 l l l.
51 Interface       Attribute       Value
53 .BR clog10 (),
54 .BR clog10f (),
55 .BR clog10l ()
56 T}      Thread safety   MT-Safe
57 .TE
58 .hy
59 .ad
60 .sp 1
61 .SH CONFORMING TO
62 These functions are GNU extensions.
63 The identifiers are reserved for future use in C99 and C11.
64 .SH SEE ALSO
65 .BR cabs (3),
66 .BR cexp (3),
67 .BR clog (3),
68 .BR clog2 (3),
69 .BR complex (7)