atan

Compute the arc tangent of a real number.

Interface Definition

C interface:

float atanf(float x);

double atan(double x);

float complex catanf(float complex x);

double complex catan(double complex x);

Fortran interface:

RES = ATANF(X)

RES = ATAN(X)

RES = CATANF(X)

RES = CATAN(X)

Parameters

Parameter	Type	Description	Input/Output
x	For atanf, x is of single-precision floating-point type. For atan, x is of double-precision floating-point type. For catanf, x is of single-precision floating-point complex number type. For catan, x is of double-precision floating-point complex number type.	Floating-point value of the input data	Input

Return Value

The unique angle whose tangent value is x at (–π/2, π/2) is returned. The value range is (–π/2, +π/2).
If the input is +0, the return value is +0.
If the input is -0, the return value is -0.
If the input is +∞, the return value is +π/2.
If the input is -∞, the return value is -π/2.
If the input is NaN, the return value is NaN.

Dependencies

C: "km.h"

Fortran: "km.f03"

Examples

C interface:

    double pi = acos(-1); 
    // typical usage 
    double a = pi/3, c = -3*pi/4, b = pi/2; 
    // special handling 
    double d = +0.0, h = -0.0, e = INFINITY, f = -INFINITY, g = NAN; 
    double complex k = 0 + 0 * I;
    // print result 
    printf("atan(pi/3) = %.15f\n", atan(a)); 
    printf("atan(-3*pi/4) = %.15f\n", atan(c)); 
    printf("atan(pi/2) = %.15f\n", atan(b)); 
    printf("atan(+0.0) = %+.15f\n", atan(d)); 
    printf("atan(-0.0) = %+.15f\n", atan(h)); 
    printf("atan(INFINITY) = %+.15f\n", atan(e)); 
    printf("atan(-INFINITY) = %+.15f\n", atan(f)); 
    printf("atan(NAN) = %.15f\n", atan(g)); 
    printf("catan(0+0*I) = %.15f + %.15f * I\n", creal(catan(k)), cimag(catan(k)));
    /* 
     *  atan(pi/3) = 0.808448792630022 
     *  atan(-3*pi/4) = -1.169422824815756 
     *  atan(pi/2) = 1.003884821853887 
     *  atan(+0.0) = +0.000000000000000 
     *  atan(-0.0) = -0.000000000000000 
     *  atan(INFINITY) = +1.570796326794897 
     *  atan(-INFINITY) = -1.570796326794897 
     *  atan(NAN) = nan 
     *  catan(0+0*I) = 0 + 0 * I
     * 
     * */

Fortran interface:

    REAL(8) :: X = 0.0 
    PRINT*,  ATAN(X) 
    ! 
    ! OUTPUT 
    !     0.000000000000000 
    !

Parent topic: Function Syntax