# FreeBSD Manual Pages

MATH(3) BSD Library Functions Manual MATH(3)NAMEmath-- floating-point mathematical libraryLIBRARYMath Library (libm, -lm)SYNOPSIS#include<math.h>DESCRIPTIONThese functions constitute the C math library.LIST OF FUNCTIONSEach of the followingdoublefunctions has afloatcounterpart with an `f' appended to the name and alongdoublecounterpart with an `l' ap- pended. As an example, thefloatandlongdoublecounterparts ofdoubleacos(doublex) arefloatacosf(floatx) andlongdoubleacosl(longdoublex), respectively.AlgebraicFunctionsNameDescriptioncbrt cube root fma fused multiply-add hypot Euclidean distance sqrt square rootClassificationFunctionsNameDescriptionfpclassify classify a floating-point value isfinite determine whether a value is finite isinf determine whether a value is infinite isnan determine whether a value isNaNisnormal determine whether a value is normalizedExponentManipulationFunctionsNameDescriptionfrexp extract exponent and mantissa ilogb extract exponent ldexp multiply by power of 2 logb extract exponent scalbln adjust exponent scalbn adjust exponentExtremum-andSign-RelatedFunctionsNameDescriptioncopysign copy sign bit fabs absolute value fdim positive difference fmax maximum function fmin minimum function signbit extract sign bitResidueandRoundingFunctionsNameDescriptionceil integer no less than floor integer no greater than fmod positive remainder llrint round to integer in fixed-point format llround round to nearest integer in fixed-point format lrint round to integer in fixed-point format lround round to nearest integer in fixed-point format modf extract integer and fractional parts nearbyint round to integer (silent) nextafter next representable value nexttoward next representable value remainder remainder remquo remainder with partial quotient rint round to integer round round to nearest integer trunc integer no greater in magnitude than Theceil(),floor(),llround(),lround(),round(), andtrunc() functions round in predetermined directions, whereasllrint(),lrint(), andrint() round according to the current (dynamic) rounding mode. For more infor- mation on controlling the dynamic rounding mode, see fenv(3) and fesetround(3).SilentOrderPredicatesNameDescriptionisgreater greater than relation isgreaterequal greater than or equal to relation isless less than relation islessequal less than or equal to relation islessgreater less than or greater than relation isunordered unordered relationTranscendentalFunctionsNameDescriptionacos inverse cosine acosh inverse hyperbolic cosine asin inverse sine asinh inverse hyperbolic sine atan inverse tangent atanh inverse hyperbolic tangent atan2 atan(y/x); complex argument cos cosine cosh hyperbolic cosine erf error function erfc complementary error function exp exponential base e exp2 exponential base 2 expm1 exp(x)-1 j0 Bessel function of the first kind of the order 0 j1 Bessel function of the first kind of the order 1 jn Bessel function of the first kind of the order n lgamma log gamma function log natural logarithm log10 logarithm to base 10 log1p log(1+x) pow exponential x**y sin trigonometric function sinh hyperbolic function tan trigonometric function tanh hyperbolic function tgamma gamma function y0 Bessel function of the second kind of the order 0 y1 Bessel function of the second kind of the order 1 yn Bessel function of the second kind of the order n Unlike the algebraic functions listed earlier, the routines in this sec- tion may not produce a result that is correctly rounded, so reproducible results cannot be guaranteed across platforms. For most of these func- tions, however, incorrect rounding occurs rarely, and then only in very- close-to-halfway cases.SEE ALSOfenv(3), ieee(3)HISTORYA math library with many of the present functions appeared in Version 7 AT&T UNIX. The library was substantially rewritten for 4.3BSD to provide better accuracy and speed on machines supporting either VAX or IEEE 754 floating-point. Most of this library was replaced with FDLIBM, developed at Sun Microsystems, in FreeBSD 1.1.5. Additional routines, including ones forfloatandlongdoublevalues, were written for or imported into subsequent versions of FreeBSD.BUGSThelog2() andnan() functions are missing, and many functions are not available in theirlongdoublevariants. Many of the routines to compute transcendental functions produce inaccu- rate results in other than the default rounding mode. On some architectures, trigonometric argument reduction is not performed accurately, resulting in errors greater than 1ulpfor large arguments tocos(),sin(), andtan(). BSD November 6, 2005 BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | LIST OF FUNCTIONS | SEE ALSO | HISTORY | BUGS

Want to link to this manual page? Use this URL:

<https://www.freebsd.org/cgi/man.cgi?query=math&sektion=3&manpath=FreeBSD+7.0-RELEASE>