ASIN()

ASIN()

Arcus sine of the argument

Syntax

      ASIN( nSine ) -> nRadiant

Arguments

<nSine> the sine of an angle

Returns

<nRadiant> the angle whose sine is <nSine>

Description

The function ASIN() is the inverse function of SIN(). It takes a sine value and returns the smallest(!) angle whose sine equals to the argument. The return value is given in radiants (full angle equals 2*Pi – see DTOR() if you need to convert it into degress). Note, that <nSine> must be between -1 and 1 and that <nRadiant> is always between -PI()/2 and PI()/2.

Examples

      ? asin( 0.0 ) // --> 0.0
      ? asin( 0.5 ) // --> 0.5235...

Tests

      asin( 0.0 ) == 0.0
      asin( sqrt( 1 / 2 ) ) == PI() / 4
      asin( 1.0 ) == PI() / 2
      asin( 0.0 ) == 0.0  // and not PI(), since the smallest angle is returned !

Compliance

ASIN() is compatible with CT3’s ASIN().

Platforms

All

Files

Source is trig.c, library is libct.

Seealso

SIN(), COS(), TAN(), COT(), ACOS(), ATAN(), ATN2(), SINH(), COSH(), TANH(), RTOD(), DTOR(), PI()

Advertisements

2 responses to “ASIN()

  1. Pingback: Harbour All Functions – A | Viva Clipper !

  2. Pingback: Harbour Math Functions | Viva Clipper !

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s