
asin(+Number, -Result)
-Result is asin(+Number)

   Evaluates the trigonometric function asin(Number) and unifies the resulting
value with Result.



Arguments
   Number              A number.
   Result              Output: float.

Type
   Arithmetic

Description

   Evaluates the trigonometric function asin(Number) and unifies the resulting
   value with Result.

   This predicate can be used as a function in arithmetic expressions.
   In coroutining mode, if Number is uninstantiated, the call to asin/2 is
   delayed until this variable is instantiated.




Modes and Determinism
   asin(+, -) is det

Exceptions
     4 --- Number is not instantiated (non-coroutining mode only).
    24 --- Number is not of a numeric type.
    20 --- Illegal arithmetic operation: Number is greater than 1 or less than -1.
   141 --- Argument is of type breal

Examples
   
Success:
    Result is asin(1.0).		% gives Result = 1.5708
    Result is asin(-0,5).		% gives Result = -0.523599

Error:
    Result is asin(2.0).		% arithmetic exception


See Also
   is / 2
