Sunlit Design > The Sun API > Documentation > sdASin Function
- Introduction
+ Using the Functions
+ User Guide
+ Function Reference
+ Constants
sdASin Function
Description
Returns the arcsine of a number. The arcsine is the angle whose sine isValue.
The returned angle is given in degrees in the range -90 to 90.
Syntax
sdASin(Value)
Value A double precision number, is the sine of
the angle you want and must be from -1 to 1.
Return Values
sdASin returns a double precision number.Errors
If this function finds any errors in it's input parameter(s) it returns -99999999
Remarks
This degree based function is provided because most programming environments provide only radian based functions.
You can convert a degree value to it's Degrees:Minute:Seconds components using the sdDUnpackx function and to a printable text format using sdD2Text function.
Example
To find the angle which has a Sine of -.5:
sdASin(-.5) equals 120