Design

Back Next

atan

The atan function in XQuery returns the arctangent (inverse tangent) of a numeric input value. It calculates the angle in radians whose tangent is the given number. The result ranges from -π/2 to π/2.

Syntax

math:atan(arg)

The following table describes the argument for this command:

Argument	Required/Optional	Description
arg	Required	A numeric value representing the tangent of an angle.

Return Value

Returns the angle in radians whose tangent is the input value

$arg

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

Returns an empty sequence if the input is an empty sequence.

Examples

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
math:atan(0)	0
math:atan(1)	0.78539816339
math:atan(-1)	-0.78539816339
math:atan(())	()

Additional information

The input value can be any numeric value (positive, negative, or zero).

The function returns the corresponding angle in radians.

It handles empty inputs gracefully by returning an empty sequence.

Unlike

atan2

, this function takes a single argument only.

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

atan

atan

Syntax

Return Value

Examples

Additional information