Formerly math.h.~12~
[kopensolaris-gnu/glibc.git] / math / math.h
1 /* Copyright (C) 1991, 1992 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB.  If
16 not, write to the, 1992 Free Software Foundation, Inc., 675 Mass Ave,
17 Cambridge, MA 02139, USA.  */
18
19 /*
20  *      ANSI Standard: 4.5 MATHEMATICS  <math.h>
21  */
22
23 #ifndef _MATH_H
24
25 #define _MATH_H 1
26 #include <features.h>
27
28 __BEGIN_DECLS
29
30 #define __need_Emath
31 #include <errno.h>
32
33 /* Get machine-dependent HUGE_VAL value (returned on overflow).  */
34 #include <huge_val.h>
35
36 /* Get machine-dependent NAN value (returned for some domain errors).  */
37 #ifdef   __USE_GNU
38 #include <nan.h>
39 #endif
40
41
42 #ifndef __CONSTVALUE
43 #ifdef  __GNUC__
44 /* The `const' keyword tells GCC that a function's return value is
45    based solely on its arguments, and there are no side-effects.  */
46 #define __CONSTVALUE    __const
47 #else
48 #define __CONSTVALUE
49 #endif /* GCC.  */
50 #endif /* __CONSTVALUE not defined.  */
51
52
53 /* Trigonometric functions.  */
54
55 /* Arc cosine of X.  */
56 extern __CONSTVALUE double acos __P ((double __x));
57 /* Arc sine of X.  */
58 extern __CONSTVALUE double asin __P ((double __x));
59 /* Arc tangent of X.  */
60 extern __CONSTVALUE double atan __P ((double __x));
61 /* Arc tangent of Y/X.  */
62 extern __CONSTVALUE double atan2 __P ((double __y, double __x));
63
64 /* Cosine of X.  */
65 extern __CONSTVALUE double cos __P ((double __x));
66 /* Sine of X.  */
67 extern __CONSTVALUE double sin __P ((double __x));
68 /* Tangent of X.  */
69 extern __CONSTVALUE double tan __P ((double __x));
70
71
72 /* Hyperbolic functions.  */
73
74 /* Hyperbolic cosine of X.  */
75 extern __CONSTVALUE double cosh __P ((double __x));
76 /* Hyperbolic sine of X.  */
77 extern __CONSTVALUE double sinh __P ((double __x));
78 /* Hyperbolic tangent of X.  */
79 extern __CONSTVALUE double tanh __P ((double __x));
80
81 #ifdef  __USE_MISC
82 /* Hyperbolic arc cosine of X.  */
83 extern __CONSTVALUE double acosh __P ((double __x));
84 /* Hyperbolic arc sine of X.  */
85 extern __CONSTVALUE double asinh __P ((double __x));
86 /* Hyperbolic arc tangent of X.  */
87 extern __CONSTVALUE double atanh __P ((double __x));
88 #endif
89
90 /* Exponential and logarithmic functions.  */
91
92 /* Exponentional function of X.  */
93 extern __CONSTVALUE double exp __P ((double __x));
94
95 /* Break VALUE into a normalized fraction and an integral power of 2.  */
96 extern double frexp __P ((double __value, int *__exp));
97
98 /* X times (two to the EXP power).  */
99 extern __CONSTVALUE double ldexp __P ((double __x, int __exp));
100
101 /* Natural logarithm of X.  */
102 extern __CONSTVALUE double log __P ((double __x));
103
104 /* Base-ten logarithm of X.  */
105 extern __CONSTVALUE double log10 __P ((double __x));
106
107 #ifdef  __USE_MISC
108 /* Return exp(X) - 1.  */
109 extern __CONSTVALUE double expm1 __P ((double __x));
110
111 /* Return log(1 + X).  */
112 extern __CONSTVALUE double log1p __P ((double __x));
113 #endif
114
115 /* Break VALUE into integral and fractional parts.  */
116 extern double modf __P ((double __value, double *__iptr));
117
118
119 /* Power functions.  */
120
121 /* Return X to the Y power.  */
122 extern __CONSTVALUE double pow __P ((double __x, double __y));
123
124 /* Return the square root of X.  */
125 extern __CONSTVALUE double sqrt __P ((double __x));
126
127 #ifdef  __USE_MISC
128 /* Return the cube root of X.  */
129 extern __CONSTVALUE double cbrt __P ((double __x));
130 #endif
131
132
133 /* Nearest integer, absolute value, and remainder functions.  */
134
135 /* Smallest integral value not less than X.  */
136 extern __CONSTVALUE double ceil __P ((double __x));
137
138 /* Absolute value of X.  */
139 extern __CONSTVALUE double fabs __P ((double __x));
140
141 /* Largest integer not greater than X.  */
142 extern __CONSTVALUE double floor __P ((double __x));
143
144 /* Floating-point modulo remainder of X/Y.  */
145 extern __CONSTVALUE double fmod __P ((double __x, double __y));
146
147
148 /* Return 0 if VALUE is finite or NaN, +1 if it
149    is +Infinity, -1 if it is -Infinity.  */
150 extern __CONSTVALUE int __isinf __P ((double __value));
151
152 /* Return nonzero if VALUE is not a number.  */
153 extern __CONSTVALUE int __isnan __P ((double __value));
154
155 /* Return nonzero if VALUE is finite and not NaN.  */
156 extern __CONSTVALUE int __finite __P ((double __value));
157 #ifdef  __OPTIMIZE__
158 #define __finite(value) (!__isinf(value))
159 #endif
160
161 /* Deal with an infinite or NaN result.
162    If ERROR is ERANGE, result is +Inf;
163    if ERROR is - ERANGE, result is -Inf;
164    otherwise result is NaN.
165    This will set `errno' to either ERANGE or EDOM,
166    and may return an infinity or NaN, or may do something else.  */
167 extern double __infnan __P ((int __error));
168
169 /* Return X with its signed changed to Y's.  */
170 extern __CONSTVALUE double __copysign __P ((double __x, double __y));
171
172 /* Return X times (2 to the Nth power).  */
173 extern __CONSTVALUE double __scalb __P ((double __x, int __n));
174
175 #ifdef  __OPTIMIZE__
176 #define __scalb(x, n)   ldexp ((x), (n))
177 #endif
178
179 /* Return the remainder of X/Y.  */
180 extern __CONSTVALUE double __drem __P ((double __x, double __y));
181
182 /* Return the base 2 signed integral exponent of X.  */
183 extern __CONSTVALUE double __logb __P ((double __x));
184
185 #ifdef  __USE_MISC
186
187 /* Return the integer nearest X in the direction of the
188    prevailing rounding mode.  */
189 extern __CONSTVALUE double rint __P ((double __x));
190
191 /* Return `sqrt(X*X + Y*Y)'.  */
192 extern __CONSTVALUE double hypot __P ((double __x, double __y));
193
194 struct __complex
195 {
196   double __x, __y;
197 };
198
199 /* Return `sqrt(X*X + Y*Y)'.  */
200 extern __CONSTVALUE double cabs __P ((struct __complex));
201
202 extern __CONSTVALUE int isinf __P ((double __value));
203 extern __CONSTVALUE int isnan __P ((double __value));
204 extern __CONSTVALUE int finite __P ((double __value));
205 extern __CONSTVALUE double infnan __P ((int __error));
206 extern __CONSTVALUE double copysign __P ((double __x, double __y));
207 extern __CONSTVALUE double scalb __P ((double __x, int __n));
208 extern __CONSTVALUE double drem __P ((double __x, double __y));
209 extern __CONSTVALUE double logb __P ((double __x));
210
211 #ifdef  __OPTIMIZE__
212 #define isinf(value)    __isinf(value)
213 #define isnan(value)    __isnan(value)
214 #define infnan(error)   __infnan(error)
215 #define finite(value)   __finite(value)
216 #define copysign(x, y)  __copysign((x), (y))
217 #define scalb(x, n)     __scalb((x), (n))
218 #define drem(x, y)      __drem((x), (y))
219 #define logb(x)         __logb(x)
220 #endif /* Optimizing.  */
221
222 #endif /* Use misc.  */
223
224
225 #if 0
226 /* The "Future Library Directions" section of the
227    ANSI Standard reserves these as `float' and
228    `long double' versions of the above functions.  */
229
230 extern __CONSTVALUE float acosf __P ((float __x));
231 extern __CONSTVALUE float asinf __P ((float __x));
232 extern __CONSTVALUE float atanf __P ((float __x));
233 extern __CONSTVALUE float atan2f __P ((float __y, float __x));
234 extern __CONSTVALUE float cosf __P ((float __x));
235 extern __CONSTVALUE float sinf __P ((float __x));
236 extern __CONSTVALUE float tanf __P ((float __x));
237 extern __CONSTVALUE float coshf __P ((float __x));
238 extern __CONSTVALUE float sinhf __P ((float __x));
239 extern __CONSTVALUE float tanhf __P ((float __x));
240 extern __CONSTVALUE float expf __P ((float __x));
241 extern float frexpf __P ((float __value, int *__exp));
242 extern __CONSTVALUE float ldexpf __P ((float __x, int __exp));
243 extern __CONSTVALUE float logf __P ((float __x));
244 extern __CONSTVALUE float log10f __P ((float __x));
245 extern float modff __P ((float __value, float *__iptr));
246 extern __CONSTVALUE float powf __P ((float __x, float __y));
247 extern __CONSTVALUE float sqrtf __P ((float __x));
248 extern __CONSTVALUE float ceilf __P ((float __x));
249 extern __CONSTVALUE float fabsf __P ((float __x));
250 extern __CONSTVALUE float floorf __P ((float __x));
251 extern __CONSTVALUE float fmodf __P ((float __x, float __y));
252
253 extern __CONSTVALUE __long_double_t acosl __P ((__long_double_t __x));
254 extern __CONSTVALUE __long_double_t asinl __P ((__long_double_t __x));
255 extern __CONSTVALUE __long_double_t atanl __P ((__long_double_t __x));
256 extern __CONSTVALUE __long_double_t atan2l __P ((__long_double_t __y, __long_double_t __x));
257 extern __CONSTVALUE __long_double_t cosl __P ((__long_double_t __x));
258 extern __CONSTVALUE __long_double_t sinl __P ((__long_double_t __x));
259 extern __CONSTVALUE __long_double_t tanl __P ((__long_double_t __x));
260 extern __CONSTVALUE __long_double_t coshl __P ((__long_double_t __x));
261 extern __CONSTVALUE __long_double_t sinhl __P ((__long_double_t __x));
262 extern __CONSTVALUE __long_double_t tanhl __P ((__long_double_t __x));
263 extern __CONSTVALUE __long_double_t expl __P ((__long_double_t __x));
264 extern __long_double_t frexpl __P ((__long_double_t __value, int *__exp));
265 extern __CONSTVALUE __long_double_t ldexpl __P ((__long_double_t __x, int __exp));
266 extern __CONSTVALUE __long_double_t logl __P ((__long_double_t __x));
267 extern __CONSTVALUE __long_double_t log10l __P ((__long_double_t __x));
268 extern __long_double_t modfl __P ((__long_double_t __value, __long_double_t * __ip));
269 extern __CONSTVALUE __long_double_t powl __P ((__long_double_t __x, __long_double_t __y));
270 extern __CONSTVALUE __long_double_t sqrtl __P ((__long_double_t __x));
271 extern __CONSTVALUE __long_double_t ceill __P ((__long_double_t __x));
272 extern __CONSTVALUE __long_double_t fabsl __P ((__long_double_t __x));
273 extern __CONSTVALUE __long_double_t floorl __P ((__long_double_t __x));
274 extern __CONSTVALUE __long_double_t fmodl __P ((__long_double_t __x, __long_double_t __y));
275 #endif /* 0 */
276
277 /* Get machine-dependent inline versions (if there are any).  */
278 #include <__math.h>
279
280 __END_DECLS
281
282 #endif /* math.h  */