asin, asinf
Visual Studio .NET 2003
Calculates the arcsine.
double asin( double x ); float asin( float x ); // C++ only long double asin( long double x ); // C++ only float asinf ( float x );
Parameter
- x
- Value whose arcsine is to be calculated.
Return Value
The asin function returns the arcsine of x in the range –π/2 to π/2 radians.
If x is less than –1 or greater than 1, asin returns an indefinite by default.
| Input | SEH Exception | Matherr Exception |
|---|---|---|
| ± ∞ | INVALID | _DOMAIN |
| ± QNAN,IND | none | _DOMAIN |
| |x|>1 | INVALID | _DOMAIN |
Remarks
C++ allows overloading, so you can call overloads of asin. In a C program, asin always takes and returns a double.
Requirements
| Routine | Required header | Compatibility |
|---|---|---|
| asin, asinf | <math.h> | ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
All versions of the C run-time libraries.
Example
See acos, acosf for a sample of using asin.
See Also
Floating-Point Support Routines | acos | atan | cos | _matherr, sin | tan | Run-Time Routines and .NET Framework Equivalents