asin, asinf, asinl

Article
06/05/2017

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