std::atan2, std::atan2f, std::atan2l

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca numérica

Funciones matemáticas comunes
Funciones matemáticas especiales (C++17)
Constantes matemáticas (C++20)
Algoritmos básicos de álgebra lineal (C++26)
Entorno de punto flotante (C++11)
Números complejos
Arrays numéricos
Generación de números pseudoaleatorios
Operaciones de factores
gcd (C++17)
lcm (C++17)
Interpolaciones
midpoint (C++20)
lerp (C++20)
Saturación aritmética
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Operaciones numéricas genéricas
iota (C++11)
ranges::iota (C++23)
accumulate
inner_product
adjacent_difference
partial_sum
reduce (C++17)
transform_reduce (C++17)
inclusive_scan (C++17)
exclusive_scan (C++17)
transform_inclusive_scan (C++17)
transform_exclusive_scan (C++17)
Operaciones de bits
bit_cast (C++20)
byteswap (C++23)
has_single_bit (C++20)
bit_ceil (C++20)
bit_floor (C++20)
bit_width (C++20)
rotl (C++20)
rotr (C++20)
countl_zero (C++20)
countl_one (C++20)
countr_zero (C++20)
countr_one (C++20)
popcount (C++20)
endian (C++20)

 

Funciones matemáticas comunes

Funciones
Operaciones básicas
abs(int)labsllabsimaxabs (C++11) abs(float)fabs divldivlldivimaxdiv (C++11) fmod	remainder (C++11) remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Funciones exponenciales
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Funciones de potencias
sqrt cbrt (C++11)	hypot (C++11) pow
Funciones trigonométricas e hiperbólicas
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)

Funciones de error y gamma
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)
Operaciones de punto flotante del entero más cercano
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Funciones de manipulación de punto flotante
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Clasificación/comparación
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Constantes de macro
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) INFINITY (C++11) NAN (C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

Definido en el archivo de encabezado <cmath>
	(1)
float atan2 ( float y, float x );
float atan2f( float y, float x );			(desde C++11)
double atan2 ( double y, double x );		(2)
		(3)
long double atan2 ( long double y, long double x );
long double atan2l( long double y, long double x );				(desde C++11)
Promovido atan2 ( Aritmético1 y, Aritmético2 x );			(4)	(desde C++11)

1-3) Calcula el arco tangente de y/x usando los signos de los argumentos para determinar el cuadrante correcto.

4) Un conjunto de sobrecargas o una plantilla de función para todas las combinaciones de los argumentos de tipo aritmético no cubiertas por (1-3). Si algún argumento tiene tipo entero, se convierte a double. Si cualquier argumento es long double, entonces el tipo de retorno Promovido también es long double, de lo contrario el tipo de retorno siempre es double.

Parámetros

y, x

-

Valores de tipos de punto flotante o tipos enteros.

Valor de retorno

See More

Si no se producen errores, se devuelve el arco tangente de y/x (

arctan(

y

x

)

) en el rango [-π , +π] radianes.

Argumento y

Valor de retorno

Argumento x

Si se produce un error de dominio, se devuelve un valor definido por la implementación (NaN donde se dé apoyo).

Si se produce un error debido a subdesbordamiento, se devuelve el resultado correcto (después del redondeo).

Manejo de errores

Los errores se informan como se especifica en math_errhandling.

Se puede producir un error de dominio si x e y son cero.

Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559):

• Si x e y son cero, no se produce un error de dominio.
• Si x e y son cero, tampoco se produce un error de rango.
• Si y es cero, no se produce un error de polo.
• Si y es ±0 y x es negativo o -0, se devuelve ±π.
• Si y es ±0 y x es positivo o +0, se devuelve ±0.
• Si y es ±∞ y x es finito, se devuelve ±π/2.
• Si y es ±∞ y x es -∞, se devuelve ±3π/4.
• Si y es ±∞ y x es +∞, se devuelve ±π/4.
• Si x es ±0 y y es negativo, se devuelve -π/2.
• Si x es ±0 y y es positive, se devuelve +π/2.
• Si x es -∞ y y es finito y positivo, se devuelve +π.
• Si x es -∞ y y es finito y negativo, se devuelve -π.
• Si x es +∞ y y es finito y positivo, se devuelve +0.
• Si x es +∞ y y es finito y negativo, se devuelve -0.
• Si x es NaN o y es NaN, se devuelve NaN.

Notas

std::atan2(y, x) es equivalente a std::arg(std::complex<double>(x,y)).

POSIX especifica que en caso de subdesbordamiento, se devuelva y/x, y si no se admite, se devuelva un valor definido por la implementación no mayor que DBL_MIN, FLT_MIN y LDBL_MIN.

Ejemplo

Ejecuta este código

#include <iostream>
#include <cmath>

int main()
{
    // uso normal: los signos de los dos argumentos determinan el cuadrante
    std::cout << "(x:+1,y:+1) cartesiano es (r:" << hypot(1,1)
              << ",phi:" << atan2(1,1) << ") polar\n"  // atan2(1,1) = +pi/4, Cuad I
              << "(x:-1,y:+1) cartesiano es (r:" << hypot(1,-1)
              << ",phi:" << atan2(1,-1) << ") polar\n" // atan2(1, -1) = +3pi/4, Cuad II
              << "(x:-1,y:-1) cartesiano es (r:" << hypot(-1,-1)
              << ",phi:" << atan2(-1,-1) << ") polar\n" // atan2(-1,-1) = -3pi/4, Cuad III
              << "(x:+1,y:-1) cartesiano es (r:" << hypot(-1,1)
              << ",phi:" << atan2(-1,1) << ") polar\n"; // atan2(-1, 1) = -pi/4, Cuad IV
    // valores especiales
    std::cout << "atan2(0, 0) = " << atan2(0,0)
              << " atan2(0,-0) = " << atan2(0,-0.0) << '\n'
              << "atan2(7, 0) = " << atan2(7,0)
              << " atan2(7,-0) = " << atan2(7,-0.0) << '\n';
}

Salida:

(x:+1,y:+1) cartesiano es (r:1.41421,phi:0.785398) polar
(x:-1,y:+1) cartesiano es (r:1.41421,phi:2.35619) polar
(x:-1,y:-1) cartesiano es (r:1.41421,phi:-2.35619) polar
(x:+1,y:-1) cartesiano es (r:1.41421,phi:-0.785398) polar
atan2(0, 0) = 0 atan2(0,-0) = 3.14159
atan2(7, 0) = 1.5708 atan2(7,-0) = 1.5708

Véase también

asinasinfasinl (C++11)(C++11)	Calcula el arco seno (\({\small\arcsin{x} }\)arcsen(x)) (función)
acosacosfacosl (C++11)(C++11)	Calcula el arco coseno (\({\small\arccos{x} }\)arccos(x)) (función)
atanatanfatanl (C++11)(C++11)	Calcula el arco tangente (\({\small\arctan{x} }\)arctan(x)) (función)
arg	Devuelve el ángulo de fase. (plantilla de función)
atan2(std::valarray)	se aplica la función std::atan2 a un valarray y un valor Original: applies the function std::atan2 to a valarray and a value The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (plantilla de función)
Documentación de C para atan2