HPlogo HP-UX Reference > T

tan(3M)

HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

NAME

tan(), tanf(), tanl(), tanw(), tanq() — tangent functions

SYNOPSIS

#include <math.h>

double tan(double x);

float tanf(float x);

Itanium(R)-based System Only

long double tanl(long double x);

extended tanw(extended x);

quad tanq(quad x);

DESCRIPTION

tan() returns the tangent of x (x specified in radians).

On PA-RISC systems, tan() may lose accuracy when x is far from zero.

tanf() is a float version of tan(); it takes a float argument and returns a float result.

Itanium-based System Only

tanl() is a long double version of tan(); it takes a long double argument and returns a long double result.

tanw() is an extended version of tan(); it takes an extended argument and returns an extended result.

tanq() is equivalent to tanl() on HP-UX systems.

USAGE

To use these functions, compile either with the default -Ae option or with the -Aa and the -D_HPUX_SOURCE options.

To use (for Itanium-based systems) tanw() or tanq(), compile also with the -fpwidetypes option.

To use any of these functions, make sure your program includes <math.h>, and link in the math library by specifying -lm on the compiler or linker command line. For more information, see the HP-UX Floating-Point Guide.

PA-RISC Only

Millicode versions of the tan() and tanf() functions are available. Millicode versions of math library functions are usually faster than their counterparts in the standard library. To use these versions, compile your program with the +Olibcalls or the +Oaggressive optimization option.

For special cases, the millicode versions return the same values as their standard library counterparts (see the RETURN VALUE section).

RETURN VALUE

tan(±0) returns ±0.

If x is ±INFINITY, tan() returns NaN and raises the invalid exception.

x is NaN, tan() returns NaN.

When it raises no other exception, whether tan() raises the inexact exception is unspecified.

ERRORS

No errors are defined.

STANDARDS CONFORMANCE

tan(): SVID3, XPG4.2, ANSI C, ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')

tanf(), tanl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')