asin, asinf, asinl

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at asin, asinf, asinl.

Calculates the arcsine.

Syntax

double asin(   
   double x   
);  
float asin(  
   float x  
);  // C++ only  
long double asin(  
   long double x  
);  // C++ only  
float asinf (   
   float x   
);  
long double asinl(  
   long double x  
);  

Parameters

x
Value whose arcsine is to be calculated.

Return Value

The asin function returns the arcsine (the inverse sine function) of x in the range –π/2 to π/2 radians.

By default, if x is less than –1 or greater than 1, asin returns an indefinite.

Input SEH Exception Matherr Exception
± ∞ INVALID _DOMAIN
± QNAN,IND none _DOMAIN
|x|>1 INVALID _DOMAIN

Remarks

Because C++ allows overloading, you can call overloads of asin with float and long double values. In a C program, asin always takes and returns a double.

Requirements

Routine Required header
asin, asinf, asinl <math.h>

Example

For more information, see acos, acosf, acosl.

.NET Framework Equivalent

System::Math::Asin

See Also

Floating-Point Support
acos, acosf, acosl
atan, atanf, atanl, atan2, atan2f, atan2l
cos, cosf, cosl, cosh, coshf, coshl
_matherr
sin, sinf, sinl, sinh, sinhf, sinhl
tan, tanf, tanl, tanh, tanhf, tanhl