xHarbour Reference Documentation > Function Reference

ASin()

Calculates the arc sine.

Syntax

ASin( <nRadians> ) --> nArcSine

Arguments

<nRadians>

A numeric value between -1 and +1 specifying the sine in radians.

Return

The function returns the arc sine as a numeric value between plus/minus Pi()/2.

Info

See also:	ACos(), ATan(), ATn2(), DtoR(), RtoD(), SetPrec(), Sin(), Tan()
Category:	CT:Math , Mathematical functions , Trigonometric functions
Source:	ct\trig.c
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example displays results of function ASin().

   PROCEDURE Main
      ? Str( ASin( -1.0 ), 18, 15)  // result: -1.570796326794897
      ? Str( ASin( -0.5 ), 18, 15)  // result: -0.523598775598299
      ? Str( ASin(    0 ), 18, 15)  // result:  0.000000000000000
      ? Str( ASin(  0.5 ), 18, 15)  // result:  0.523598775598299
      ? Str( ASin(  1.0 ), 18, 15)  // result:  1.570796326794897
   RETURN