std::polar(std::complex)

 

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)

 

std::complex

Funciones miembro
complex::complex
complex::operator=
complex::real
complex::imag
complex::operator+=complex::operator-=complex::operator*=complex::operator/=
Funciones no miembro
operator+operator- operator+operator-operator*operator/ operator==operator!= (hasta C++20) operator<<operator>>	real imag abs arg norm conj proj (C++11) polar operator""ioperator""ifoperator""il (C++14)(C++14)(C++14)
Funciones exponenciales
exp
log
log10
Funciones de potencias
pow
sqrt
Funciones trigonométricas
sin cos tan	asin (C++11) acos (C++11) atan (C++11)
Funciones hiperbólicas
sinh cosh tanh	asinh (C++11) acosh (C++11) atanh (C++11)

 

Definido en el archivo de encabezado <complex>
template<class T > complex<T> polar(const T& r, const T& theta = T());

Devuelve un número complejo con magnitud r y ángulo de fase theta.

El comportamiento no está definido si r es negativo o NaN, o si theta es infinito.

Parámetros

r	-	La magnitud.
theta	-	El ángulo de fase.

Valor de retorno

Un número complejo determinado por r y theta.

Notas

std::polar(r, theta) es equivelente a cualquiera de las expresiones siguientes:

• r *std::exp(theta * 1i)
• r *(cos(theta)+ sin(theta)* 1i)
• std::complex(r * cos(theta), r * sin(theta)).

Usar polar en lugar de exp puede ser aproximadamente 4.5x más rápido en bucles vectorizados.

Ejemplo

Ejecuta este código

#include <cmath>#include <complex>#include <iomanip>#include <iostream>#include <numbers>usingnamespace std::complex_literals;   int main(){constexprauto π_2 {std::numbers::pi/2.0};constexprauto mag {1.0};   std::cout<<std::fixed<<std::showpos<<std::setprecision(1)<<" θ: │ polar: │ exp: │ complex: │ trig:\n";for(int n{}; n !=4;++n){constauto θ {n * π_2};std::cout<<std::setw(4)<<90* n <<"° │ "<< std::polar(mag, θ)<<" │ "<< mag *std::exp(θ * 1.0i)<<" │ "<<std::complex(mag * cos(θ), mag * sin(θ))<<" │ "<< mag *(cos(θ)+ 1.0i * sin(θ))<<'\n';}}

Salida:

 θ: │ polar: │ exp: │ complex: │ trig: +0° │ (+1.0,+0.0) │ (+1.0,+0.0) │ (+1.0,+0.0) │ (+1.0,+0.0) +90° │ (+0.0,+1.0) │ (+0.0,+1.0) │ (+0.0,+1.0) │ (+0.0,+1.0) +180° │ (-1.0,+0.0) │ (-1.0,+0.0) │ (-1.0,+0.0) │ (-1.0,+0.0) +270° │ (-0.0,-1.0) │ (-0.0,-1.0) │ (-0.0,-1.0) │ (-0.0,-1.0)

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 2459	C++98	El comportamiento no estaba claro para algunas entradas.	Se hizo no definido.
LWG 2870	C++98	El valor por defecto del parámetro theta no era dependiente,	Se hizo dependiente.

Véase también

abs(std::complex)	Devuelve la magnitud de un número complejo. (plantilla de función)
arg	Devuelve el ángulo de fase. (plantilla de función)
exp(std::complex)	Base e exponencial compleja. (plantilla de función)