/* Copyright (c) 2002, Michael Stumpf Portions of documentation Copyright (c) 1990 - 1994 The Regents of the University of California. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /* $Id: math.h,v 1.4 2002/12/12 19:57:34 joerg_wunsch Exp $ */ /* math.h - mathematical functions Author : Michael Stumpf Michael.Stumpf@t-online.de __ATTR_CONST__ added by marekm@linux.org.pl for functions that "do not examine any values except their arguments, and have no effects except the return value", for better optimization by gcc. */ #ifndef __MATH_H #define __MATH_H /** \defgroup avr_math Mathematics \code #include \endcode This header file declares basic mathematics constants and functions. \note In order to access the functions delcared herein, it is usually also required to additionally link against the library \c libm.a. See also the related \ref faq_libm "FAQ entry". */ /** \ingroup avr_math The constant \c pi. */ #define M_PI 3.141592653589793238462643 /** \ingroup avr_math The square root of 2. */ #define M_SQRT2 1.4142135623730950488016887 #ifndef DOXYGEN #ifndef __ATTR_CONST__ #define __ATTR_CONST__ __attribute__((__const__)) #endif #endif /* !DOXYGEN */ #ifdef __cplusplus extern "C" { #endif /** \ingroup avr_math The cos() function returns the cosine of \c x, measured in radians. */ extern double cos(double __x) __ATTR_CONST__; /** \ingroup avr_math The fabs() function computes the absolute value of a floating-point number \c x. */ extern double fabs(double __x) __ATTR_CONST__; #if 0 /* fabs seems to be built in already */ extern inline double fabs( double __x ) { double __res; __asm__ __volatile__ ("andi %D0,0x7F \n\t" : "=d" (__res) : "0" (__x) ); return __res; } #endif /** \ingroup avr_math The function fmod() returns the floating-point remainder of x / y. */ extern double fmod(double __x, double __y) __ATTR_CONST__; /** \ingroup avr_math The modf() function breaks the argument \c value into integral and fractional parts, each of which has the same sign as the argument. It stores the integral part as a double in the object pointed to by \c iptr. The modf() function returns the signed fractional part of \c value. */ extern double modf(double __value, double *__iptr); /** \ingroup avr_math The sin() function returns the sine of \c x, measured in radians. */ extern double sin(double __x) __ATTR_CONST__; /** \ingroup avr_math The sqrt() function returns the non-negative square root of \c x. */ extern double sqrt(double __x) __ATTR_CONST__; /** \ingroup avr_math The tan() function returns the tangent of \c x, measured in radians. */ extern double tan(double __x) __ATTR_CONST__; /** \ingroup avr_math The floor() function returns the largest integral value less than or equal to \c x, expressed as a floating-point number. */ extern double floor(double __x) __ATTR_CONST__; /** \ingroup avr_math The ceil() function returns the smallest integral value greater than or equal to \c x, expressed as a floating-point number. */ extern double ceil(double __x) __ATTR_CONST__; /** \ingroup avr_math The frexp() function breaks a floating-point number into a normalized fraction and an integral power of 2. It stores the integer in the \c int object pointed to by \c exp. The frexp() function returns the value \c x, such that \c x is a double with magnitude in the interval [1/2, 1) or zero, and \c value equals \c x times 2 raised to the power \c *exp. If value is zero, both parts of the result are zero. */ extern double frexp(double __value, int *__exp); /** \ingroup avr_math The ldexp() function multiplies a floating-point number by an integral power of 2. The ldexp() function returns the value of \c x times 2 raised to the power \c exp. If the resultant value would cause an overflow, the global variable errno is set to ERANGE, and the value NaN is returned. */ extern double ldexp(double __x, int __exp) __ATTR_CONST__; /** \ingroup avr_math The exp() function returns the exponential value of \c x. */ extern double exp(double _x) __ATTR_CONST__; /** \ingroup avr_math The cosh() function returns the hyperbolic cosine of \c x. */ extern double cosh(double __x) __ATTR_CONST__; /** \ingroup avr_math The sinh() function returns the hyperbolic sine of \c x. */ extern double sinh(double __x) __ATTR_CONST__; /** \ingroup avr_math The tanh() function returns the hyperbolic tangent of \c x. */ extern double tanh(double __x) __ATTR_CONST__; /** \ingroup avr_math The acos() function computes the principal value of the arc cosine of \c x. The returned value is in the range [0, pi] radians. A domain error occurs for arguments not in the range [-1, +1]. */ extern double acos(double __x) __ATTR_CONST__; /** \ingroup avr_math The asin() function computes the principal value of the arc sine of \c x. The returned value is in the range [0, pi] radians. A domain error occurs for arguments not in the range [-1, +1]. */ extern double asin(double __x) __ATTR_CONST__; /** \ingroup avr_math The atan() function computes the principal value of the arc tangent of \c x. The returned value is in the range [0, pi] radians. A domain error occurs for arguments not in the range [-1, +1]. */ extern double atan(double __x) __ATTR_CONST__; /** \ingroup avr_math The atan2() function computes the principal value of the arc tangent of y / x, using the signs of both arguments to determine the quadrant of the return value. The returned value is in the range [-pi, +pi] radians. If both \c x and \c y are zero, the global variable \c errno is set to \c EDOM. */ extern double atan2(double __y, double __x) __ATTR_CONST__; /** \ingroup avr_math The log() function returns the natural logarithm of argument \c x. If the argument is less than or equal 0, a domain error will occur. */ extern double log(double __x) __ATTR_CONST__; /** \ingroup avr_math The log() function returns the logarithm of argument \c x to base 10. If the argument is less than or equal 0, a domain error will occur. */ extern double log10(double __x) __ATTR_CONST__; /** \ingroup avr_math The function pow() returns the value of \c x to the exponent \c y. */ extern double pow(double __x, double __y) __ATTR_CONST__; /** \ingroup avr_math The function isnan() returns 1 if the argument \c x represents a "not-a-number" (NaN) object, otherwise 0. */ extern int isnan(double __x) __ATTR_CONST__; /** \ingroup avr_math The function isinf() returns 1 if the argument \c x is either positive or negative infinity, otherwise 0. */ extern int isinf(double __x) __ATTR_CONST__; /** \ingroup avr_math The function square() returns x * x. \note This function does not belong to the C standard definition. */ extern double square(double __x) __ATTR_CONST__; /** \ingroup avr_math The function inverse() returns 1 / x. \note This function does not belong to the C standard definition. */ extern double inverse(double) __ATTR_CONST__; #ifdef __cplusplus } #endif #endif /* _MATH_H */