math:tan
Returns the tangent of the argument. The argument is an angle in radians.
Signature
math:tan($θ as xs:double?) as xs:double?Properties
This function is deterministic, context-independent, and focus-independent.
Rules
If $θ is the empty sequence, the function returns the empty
sequence.
Otherwise the result is the tangent of $θ (which is treated as an angle
in radians) as defined in the [IEEE 754-2008] specification of the
tan function applied to 64-bit binary floating point values.
Notes
The treatment of the invalidOperation and underflow exceptions
is defined in Arithmetic operators on numeric values.
If $θ is positive or negative infinity, or NaN,
then the result is NaN.
Examples
The expression math:tan(()) returns ().
The expression math:tan(0) returns 0.0e0.
The expression math:tan(-0.0e0) returns -0.0e0.
The expression math:tan(math:pi() div 4) returns 1.0e0 (approximately).
The expression math:tan(-math:pi() div 4) returns -1.0e0 (approximately).
The expression 1 div math:tan(math:pi() div 2) returns 0.0e0 (approximately). (Mathematically, tan(π/2) is positive infinity. But because math:pi() div 2
returns an approximation, the result of math:tan(math:pi() div 2) will be a large
but finite number.)
The expression 1 div math:tan(-math:pi() div 2) returns -0.0e0 (approximately). (Mathematically, tan(-π/2) is negative infinity. But because -math:pi() div 2
returns an approximation, the result of math:tan(-math:pi() div 2) will be a large
but finite negative number.)
The expression math:tan(math:pi()) returns 0.0e0 (approximately).
The expression math:tan(xs:double('NaN')) returns xs:double('NaN').
The expression math:tan(xs:double('INF')) returns xs:double('NaN').
The expression math:tan(xs:double('-INF')) returns xs:double('NaN').