CFML Reference
ColdFusion Functions

ASin

Description

Determines the arcsine of a number. The arcsine is the angle whose sine is number.

Return value

The arcsine of a number, in radians.

Category

Mathematical functions

Syntax

ASin(number) 

See also

Sin, Cos, Pi, Tan

Parameters

Parameter	Description
number	Sine of an angle. The value must be between -1 and 1, inclusive.

Usage

The range of the result is -π/2 to π/2 radians. To convert degrees to radians, multiply degrees by π/180. To convert radians to degrees, multiply radians by 180/π.

Example

<h3>ASin Example</h3>
<!--- output its arcsine value --->
<cfif IsDefined("FORM.SinNum")>
  <cfif IsNumeric(FORM.SinNum)>
    <cfif FORM.SinNum LESS THAN OR EQUAL TO 1>
      <cfif FORM.SinNum GREATER THAN OR EQUAL TO -1>
        ASin(<cfoutput>#FORM.SinNum#</cfoutput>) = 
         <cfoutput>#Evaluate(ASin(FORM.sinNum))# Radians</cfoutput>
         <br> or <br>ASin(<cfoutput>#FORM.SinNum#</cfoutput>) = 
        <cfoutput>
          #Evaluate(ASin(FORM.sinNum) * 180/Pi())# Degrees
        </cfoutput>
      <cfelse>
<!--- if it is less than negative one, output an error message --->
        <h4>Enter the sine of the angle to calculate, in degrees and radians. 
        The value must be between 1 and -1, inclusive.</h4>
      </cfif>
    <cfelse>
<!--- if it is greater than one, output an error message --->
    <h4>Enter the sine of the angle to calculate, in degrees and radians. The
value must be between 1 and -1, inclusive.</h4>
    </cfif>    
  <cfelse>
<!--- if it is empty, output an error message --->
    <h4>Enter the sine of the angle to calculate, in degrees and radians. The
value must be between 1 and -1,inclusive.</h4>
  </cfif>  
</cfif>
<form action = "asin.cfm">
<p>Enter a number to get its arcsine in Radians and Degrees.
<br><input type = "Text" name = "sinNum" size = "25">
<p><input type = "Submit" name = ""> <input type = "RESET">
</form>

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments