Design

Back Next

asin

The asin function in XQuery returns the arcsine (inverse sine) of a numeric input value. The input represents the sine of an angle, and the function returns the angle in radians, within the range -π/2 to π/2.

Syntax

math:asin(arg)

The following table describes the argument for this command:

Argument	Required/Optional	Description
arg	Required	A numeric value representing the sine of an angle; valid input range is -1 to 1.

Return Value

Returns the angle in radians whose sine is the input value

$arg

Returns the arc sine of the argument, the result being in the range -π/2 to +π/2 radians.

Returns an empty sequence if the input is an empty sequence or if the input is outside the valid range (-1 to 1).

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
math:asin(0)	0
math:asin(1)	1.57079632679
math:asin(-1)	-1.57079632679
math:asin(1.5)	Empty sequence
math:asin(())	()

Additional information

The input value must be between -1 and 1 inclusive to be valid.

The function returns the corresponding angle in radians.

It gracefully handles empty inputs by returning an empty sequence.

Math functions

Download Guide

Watch

Comments

Cloud Application Integration Homepage

0 COMMENTS

We’d like to hear from you! Log in to comment.

Rename Saved Search

Table of Contents

Design

Design

asin

asin

Syntax

Return Value

Examples

Additional information