Design

Back Next

acos

The acos function in XQuery returns the arc cosine, that is inverse cosine of a numeric input value. The input represents the cosine of an angle, and the function returns the angle in radians, within the range 0 to π.

Syntax

math:acos(arg)

The following table describes the argument for this command:

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

Return Value

Returns the angle in radians whose cosine is the input value

$arg

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

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
math:acos(1)	0
math:acos(0)	1.57079632679
math:acos(-1)	3.14159265359
math:acos(1.5)	empty sequence
math:acos(())	()

Additional information

The function expects the input value to be between -1 and 1 inclusive. Values outside this range are invalid.

The result is given in radians.

The function 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

acos

acos

Syntax

Return Value

Examples

Additional information