/** @file ../include/math.h

@internalComponent

*/

/** @fn nanval(void )

Not a number value.

@publishedAll

@released

*/

/** @fn  finite(double x)

@param x

  The finite finitef and finitel functions  return  a  non-zero value if value is neither

infinite nor a "not-a-number" (NaN) value, and 0 otherwise.

 - Examples

 @code

#include <math.h>

int main( void )

{

   double x;

   int y; 

   x = 1.34565;

   y = finite( x );

   printf( "finite( %f ) =  %d

", x, y );

   y = finitef( x );

   printf( "finitef( %f ) = %d

",x, y );

   y = finitel( x );

   printf( "finitel( %f ) = %d

",x, y );

}

@endcode

 Output

@code

finite ( 1.34565 ) = 1

finitef( 1.34565 ) = 1

finitel( 1.34565 ) =

@endcode

@publishedAll

@released

*/

/** @fn  finitef(float x)

@param x

@publishedAll

@released

*/

/** @fn  acos(double x)

@param x

@return   The acos, acosf, and acosl functions return the arc cosine in the range [0, pi]

radians.

If: | x | \> 1 , acos (x); returns an NaN.

- Detailed description

 The acos, acosf, and acosl functions compute the principal value of the arc cosine of x .

- Examples

@code

#include <math.h>

int main( )

{

   double x = -1;

   double y = acos( x );

   printf( "acos(%f) = %f

", x, y );

   y = acosf( x );

   printf( "acosf(%f) = %f

", x, y );

   y = acosl( x );

   printf( "acosl(%f) = %f

", x, y ); 

}

@endcode

 Output

@code

acos( -1.000000 ) = 3.14159

acosf(-1.000000 ) = 3.14159

acosl(-1.000000 ) = 3.14159

@endcode

@see asin()

@see atan()

@see atan2()

@see cos()

@see cosh()

@see math()

@see sin()

@see sinh()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  asin(double x)

@param x

@return   The asin, asinf, and asinl functions return the arc sine in the range

-words [-pi/2, +pi/2]

radians.

If: | x | \> 1 asin (x); returns an NaN.

- Detailed description

  The asin and asinf functions compute the principal value of the arc sine of x .

The function asinl is an alias to the function asin. A domain error occurs for arguments not in the range [-1, +1].

- Examples

@code

#include <math.h>

int main( )

{

   double x = 0.5; 

   double y = asin( x );

   printf( "asin(%f) = %f

", x, y );

   y = asinf( x );

   printf( "asinf(%f) = %f

", x, y );

   y = asinl( x );

   printf( "asinl(%f) = %f

", x, y ); 

}

@endcode

 Output

@code

asin( 0.500000 ) = 0.523599

asinf(0.500000 ) = 0.523599

asinl(0.500000 ) = 0.523599

@endcode

@see acos()

@see atan()

@see atan2()

@see cos()

@see cosh()

@see math()

@see sin()

@see sinh()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  atan(double x)

@param x

@see acos()

@see asin()

@see atan2()

@see cos()

@see cosh()

@see math()

@see sin()

@see sinh()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  atan2(double y, double x)

@param y

@param x

@see acos()

@see asin()

@see atan()

@see cos()

@see cosh()

@see math()

@see sin()

@see sinh()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  cos(double x)

@param x

@see acos()

@see asin()

@see atan()

@see atan2()

@see cosh()

@see math()

@see sin()

@see sinh()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  sin(double x)

@param x

@return   The sin and the sinf functions return the sine value.

- Detailed description

  The sin and the sinf functions compute the sine of x (measured in radians).

A large magnitude argument may yield a result with little

or no significance. sinl is just an alias to the function sin

- Examples

@code

#include <math.h>

int main( )

{

   double pi_by_6 = 0.52359877559829887307710723054658383 ;

   double y;

   y = sin( pi_by_6 );

   printf( "sin( %f)  = %f

", x1,  y );

   y = sinf( pi_by_6);

   printf( "sinf( %f) = %f

", pi_by_6, y );

   y = sinl( pi_by_6);

   printf( "sinl( %f) = %f

", pi_by_6, y );

 }

@endcode

 Output

@code

sin ( 0.52359877559829887307710723054658383 ) = 0.500000

sinf( 0.52359877559829887307710723054658383 ) = 0.500000

sinl( 0.52359877559829887307710723054658383 ) = 0.500000

@endcode

@see acos()

@see asin()

@see atan()

@see atan2()

@see cos()

@see cosh()

@see math()

@see sinh()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  tan(double x)

@param x

@return   The tan function returns the tangent value.

- Detailed description

  The tan and tanf functions compute the tangent of x (measured in radians).

A large magnitude argument may yield a result

with little or no significance.

The function tanl is an alias to the function tan

- Examples

@code

#include <math.h>

int main( )

{

   double pi_by_4 = 0.7853981633974483096156608458198757;

   double y;

   y = tan( pi_by_4 );

   printf( "tan( %f)  = %f

", pi_by_4,  y );

   y = tanf( pi_by_4);

   printf( "tanf( %f) = %f

", pi_by_4, y );

   y = tanl( pi_by_4);

   printf( "tanl( %f) = %f

", pi_by_4, y );

}

@endcode

 Output

@code

tan ( 0.7853981633974483096156608458198757 ) = 1.000000

tanf( 0.7853981633974483096156608458198757 ) = 1.000000

tanl( 0.7853981633974483096156608458198757; ) =1.000000

@endcode

@see acos()

@see asin()

@see atan()

@see atan2()

@see cos()

@see cosh()

@see math()

@see sin()

@see sinh()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  cosh(double x)

@param x

@see acos()

@see asin()

@see atan()

@see atan2()

@see cos()

@see math()

@see sin()

@see sinh()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  sinh(double x)

@param x

- Detailed description

  The sinh and the sinhf functions compute the hyperbolic sine of x .

The function sinhl is an alias to the function sinh

- Examples

@code

#include <math.h>

int main( )

{

   double inp = 0.75;

   double y;

   y = sinh( inp );

   printf( "sinh( %f)  = %f

", inp,  y );

   y = sinhf( inp);

   printf( "sinhf( %f) = %f

", inp, y );

   y = sinhl( inp);

   printf( "sinhl( %f) = %f

", inp, y );

}

@endcode

 Output

@code

sinh ( 0.75 ) = 0.8223167

sinhf( 0.75 ) = 0.8223167

sinhl( 0.75 ) = 0.8223167

@endcode

@see acos()

@see asin()

@see atan()

@see atan2()

@see cos()

@see cosh()

@see math()

@see sin()

@see tan()

@see tanh()

@publishedAll

@externallyDefinedApi

*/

/** @fn  tanh(double x)

@param x

@return   The tanh, tanhf and tanhl functions return the hyperbolic tangent value.

- Detailed description

  The tanh and tanhf functions compute the hyperbolic tangent of x . tanhl is an alias to the function tanh.

- Examples

@code

#include <math.h>

int main( )

{

   double inp = 1.0;

   double y; 

   y = tanh( inp );

   printf( "tanh( %f)  = %f

", inp,  y );

   y = tanhf( inp);

   printf( "tanhf( %f) = %f

", inp, y );

   y = tanhl( inp);

   printf( "tanhl( %f) = %f

", inp, y );

   inp = 2209.0;

   y = sqrt( inp);

   printf( "sqrt( %f)  = %d

", inp,  y );

   y = sqrtf( inp);

   printf( "sqrtf( %f) = %d

", inp, y );

   y = sqrtl( inp);

   printf( "sqrtl( %f) = %d

", inp, y );

}

@endcode

 Output

@code

tanh ( 1.000000 ) = 0.7615941

tanhf( 1.000000 ) = 0.7615941

tanhl( 1.000000 ) = 0.7615941

@endcode

@see acos()

@see asin()

@see atan()

@see atan2()

@see cos()

@see cosh()

@see math()

@see sin()

@see sinh()

@see tan()

@publishedAll

@externallyDefinedApi

*/

/** @fn  exp(double x)

@param x

@return   These functions will return the appropriate computation unless an error

occurs or an argument is out of range.

The functions pow (x, y); and powf (x, y); return an NaN if x \< 0 and y is not an integer.

An attempt to take the logarithm of ±0 will return infinity.

An attempt to take the logarithm of a negative number will

return a NaN.

- Detailed description

  The exp and expf functions compute the base e exponential value of the given argument x .

 The exp2 and exp2f functions compute the base 2 exponential of the given argument x .

 The expm1 and expm1f functions compute the value exp(x)-1 accurately even for tiny argument x .

 The log and logf functions compute the value of the natural logarithm of argument x .

 The log10 and log10f functions compute the value of the logarithm of argument x to base 10.

 The log1p and log1pf functions compute

the value of log(1+x) accurately even for tiny argument x .

 The pow and powf functions compute the value

of x to the exponent y .

 Here the long double version APIs are aliases to the double version APIs.

All apis \<function\>l behaves similiar to that \<function\>.

- Examples

@code

#include <math.h>

int main( void )

{

   double x, y;

   x = 1.0;

   y = exp( x );

   printf( "exp( %f ) = %f

", x, y );

   y = expf( x );

   printf( "expf( %f ) = %f

",x, y );

   y = expl( x );

   printf( "expl( %f ) = %f

",x, y );

   x = 0.0;

   y = exp2( x );

   printf( "exp2( %f ) = %f

", x, y );

   y = exp2f( x );

   printf( "exp2f( %f ) = %f

",x, y );

   y = exp2l( x );

   printf( "exp2l( %f ) = %f

",x, y );

   x = 1.0 ;

   y = expm1( x );

   printf( "expm1( %f ) = %f

", x, y );

   y = expm1f( x );