]>
Commit | Line | Data |
---|---|---|
4cca6b86 UD |
1 | /* Prototype declarations for complex math functions; |
2 | helper file for <complex.h>. | |
dff8da6b | 3 | Copyright (C) 1997-2024 Free Software Foundation, Inc. |
4cca6b86 UD |
4 | This file is part of the GNU C Library. |
5 | ||
6 | The GNU C Library is free software; you can redistribute it and/or | |
41bdb6e2 AJ |
7 | modify it under the terms of the GNU Lesser General Public |
8 | License as published by the Free Software Foundation; either | |
9 | version 2.1 of the License, or (at your option) any later version. | |
4cca6b86 UD |
10 | |
11 | The GNU C Library is distributed in the hope that it will be useful, | |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
41bdb6e2 | 14 | Lesser General Public License for more details. |
4cca6b86 | 15 | |
41bdb6e2 | 16 | You should have received a copy of the GNU Lesser General Public |
59ba27a6 | 17 | License along with the GNU C Library; if not, see |
5a82c748 | 18 | <https://www.gnu.org/licenses/>. */ |
4cca6b86 | 19 | |
76b87c03 | 20 | /* NOTE: Because of the special way this file is used by <complex.h>, this |
4cca6b86 UD |
21 | file must NOT be protected from multiple inclusion as header files |
22 | usually are. | |
23 | ||
24 | This file provides prototype declarations for the math functions. | |
25 | Most functions are declared using the macro: | |
26 | ||
27 | __MATHCALL (NAME, (ARGS...)); | |
28 | ||
29 | This means there is a function `NAME' returning `double' and a function | |
30 | `NAMEf' returning `float'. Each place `_Mdouble_' appears in the | |
31 | prototype, that is actually `double' in the prototype for `NAME' and | |
32 | `float' in the prototype for `NAMEf'. Reentrant variant functions are | |
33 | called `NAME_r' and `NAMEf_r'. | |
34 | ||
35 | Functions returning other types like `int' are declared using the macro: | |
36 | ||
37 | __MATHDECL (TYPE, NAME, (ARGS...)); | |
38 | ||
39 | This is just like __MATHCALL but for a function returning `TYPE' | |
40 | instead of `_Mdouble_'. In all of these cases, there is still | |
41 | both a `NAME' and a `NAMEf' that takes `float' arguments. */ | |
42 | ||
43 | #ifndef _COMPLEX_H | |
5107cf1d | 44 | #error "Never use <bits/cmathcalls.h> directly; include <complex.h> instead." |
4cca6b86 UD |
45 | #endif |
46 | ||
fcee5905 PM |
47 | #ifndef _Mdouble_complex_ |
48 | # define _Mdouble_complex_ _Mdouble_ _Complex | |
49 | #endif | |
4cca6b86 UD |
50 | |
51 | ||
52 | /* Trigonometric functions. */ | |
53 | ||
54 | /* Arc cosine of Z. */ | |
55 | __MATHCALL (cacos, (_Mdouble_complex_ __z)); | |
56 | /* Arc sine of Z. */ | |
57 | __MATHCALL (casin, (_Mdouble_complex_ __z)); | |
58 | /* Arc tangent of Z. */ | |
59 | __MATHCALL (catan, (_Mdouble_complex_ __z)); | |
60 | ||
61 | /* Cosine of Z. */ | |
62 | __MATHCALL (ccos, (_Mdouble_complex_ __z)); | |
63 | /* Sine of Z. */ | |
64 | __MATHCALL (csin, (_Mdouble_complex_ __z)); | |
65 | /* Tangent of Z. */ | |
66 | __MATHCALL (ctan, (_Mdouble_complex_ __z)); | |
67 | ||
68 | ||
69 | /* Hyperbolic functions. */ | |
70 | ||
71 | /* Hyperbolic arc cosine of Z. */ | |
72 | __MATHCALL (cacosh, (_Mdouble_complex_ __z)); | |
73 | /* Hyperbolic arc sine of Z. */ | |
74 | __MATHCALL (casinh, (_Mdouble_complex_ __z)); | |
75 | /* Hyperbolic arc tangent of Z. */ | |
76 | __MATHCALL (catanh, (_Mdouble_complex_ __z)); | |
77 | ||
78 | /* Hyperbolic cosine of Z. */ | |
79 | __MATHCALL (ccosh, (_Mdouble_complex_ __z)); | |
80 | /* Hyperbolic sine of Z. */ | |
81 | __MATHCALL (csinh, (_Mdouble_complex_ __z)); | |
82 | /* Hyperbolic tangent of Z. */ | |
83 | __MATHCALL (ctanh, (_Mdouble_complex_ __z)); | |
84 | ||
85 | ||
86 | /* Exponential and logarithmic functions. */ | |
87 | ||
88 | /* Exponential function of Z. */ | |
89 | __MATHCALL (cexp, (_Mdouble_complex_ __z)); | |
90 | ||
91 | /* Natural logarithm of Z. */ | |
92 | __MATHCALL (clog, (_Mdouble_complex_ __z)); | |
93 | ||
dfd2257a UD |
94 | #ifdef __USE_GNU |
95 | /* The base 10 logarithm is not defined by the standard but to implement | |
96 | the standard C++ library it is handy. */ | |
97 | __MATHCALL (clog10, (_Mdouble_complex_ __z)); | |
98 | #endif | |
4cca6b86 UD |
99 | |
100 | /* Power functions. */ | |
101 | ||
102 | /* Return X to the Y power. */ | |
103 | __MATHCALL (cpow, (_Mdouble_complex_ __x, _Mdouble_complex_ __y)); | |
104 | ||
105 | /* Return the square root of Z. */ | |
106 | __MATHCALL (csqrt, (_Mdouble_complex_ __z)); | |
107 | ||
108 | ||
b4012b75 | 109 | /* Absolute value, conjugates, and projection. */ |
4cca6b86 UD |
110 | |
111 | /* Absolute value of Z. */ | |
3e5f5557 | 112 | __MATHDECL (_Mdouble_,cabs, (_Mdouble_complex_ __z)); |
4cca6b86 UD |
113 | |
114 | /* Argument value of Z. */ | |
3e5f5557 | 115 | __MATHDECL (_Mdouble_,carg, (_Mdouble_complex_ __z)); |
4cca6b86 UD |
116 | |
117 | /* Complex conjugate of Z. */ | |
118 | __MATHCALL (conj, (_Mdouble_complex_ __z)); | |
119 | ||
120 | /* Projection of Z onto the Riemann sphere. */ | |
121 | __MATHCALL (cproj, (_Mdouble_complex_ __z)); | |
122 | ||
123 | ||
124 | /* Decomposing complex values. */ | |
125 | ||
126 | /* Imaginary part of Z. */ | |
3e5f5557 | 127 | __MATHDECL (_Mdouble_,cimag, (_Mdouble_complex_ __z)); |
4cca6b86 UD |
128 | |
129 | /* Real part of Z. */ | |
3e5f5557 | 130 | __MATHDECL (_Mdouble_,creal, (_Mdouble_complex_ __z)); |