Namespaces
Variants

std:: atan (std::complex)

From cppreference.net
C++
Numerics library
std::complex
Definido en el encabezado <complex>
template < class T >
complex < T > atan ( const complex < T > & z ) ;
(desde C++11)

Calcula el arco tangente complejo de un valor complejo z . Existe un corte de rama fuera del intervalo [−i, +i] a lo largo del eje imaginario.

Contenidos

Parámetros

z - valor complejo

Valor de retorno

Si no ocurren errores, se devuelve el arcotangente complejo de z , en el rango de una franja no acotada a lo largo del eje imaginario y en el intervalo [−π/2, +π/2] a lo largo del eje real.

Los errores y casos especiales se manejan como si la operación estuviera implementada por - i * std::atanh ( i * z ) , donde i es la unidad imaginaria.

Notas

La tangente inversa (o arcotangente) es una función multivaluada y requiere un corte de rama en el plano complejo. El corte de rama se coloca convencionalmente en los segmentos de línea (-∞i,-i) y (+i,+∞i) del eje imaginario.

The mathematical definition of the principal value of inverse tangent is atan z = -
1
2
i [ln(1 - iz) - ln (1 + iz)] .

Ejemplo

Ejecutar este código 
#include <cmath>
#include <complex>
#include <iostream>
int main()
{
    std::cout << std::fixed;
    std::complex<double> z1(0.0, 2.0);
    std::cout << "atan" << z1 << " = " << std::atan(z1) << '\n';
    std::complex<double> z2(-0.0, 2.0);
    std::cout << "atan" << z2 << " (the other side of the cut) = "
              << std::atan(z2) << '\n';
    std::complex<double> z3(0.0, INFINITY);
    std::cout << "2 * atan" << z3 << " = " << 2.0 * std::atan(z3) << '\n';
}

Salida: 

atan(0.000000,2.000000) = (1.570796,0.549306)
atan(-0.000000,2.000000) (the other side of the cut) = (-1.570796,0.549306)
2 * atan(0.000000,inf) = (3.141593,0.000000)

Véase también

(C++11)
calcula el arco seno de un número complejo ( arcsin(z) )
(plantilla de función)
(C++11)
calcula el arco coseno de un número complejo ( arccos(z) )
(plantilla de función)
calcula la tangente de un número complejo ( tan(z) )
(plantilla de función)
(C++11) (C++11)
calcula el arco tangente ( arctan(x) )
(función)
aplica la función std::atan a cada elemento del valarray
(plantilla de función)
Documentación C para catan