std::log(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> log(const complex<T>& z );

Calcula el logaritmo natural complejo (base e) de un valor complejo z con un punto de ramificación a lo largo del eje real negativo.

Parámetros

z

-

El valor complejo.

Valor de retorno

Si no se producen errores, se devuelve el logaritmo natural complejo de z, en el rango de una franja en el intervalo [−iπ, +iπ] a lo largo del eje imaginario y matemáticamente ilimitado a lo largo el eje real.

Manejo de errores y valores especiales

Los errores se informan de acuerdo con math_errhandling.

Si la implementación es compatible con la aritmética de punto flotante IEEE,

• La función es continua sobre el punto de ramificación teniendo en cuenta el signo de la parte imaginaria.
• std::log(std::conj(z))==std::conj(std::log(z)).
• Si z es (-0,+0), el resultado es (-∞,π) y se produce FE_DIVBYZERO.
• Si z es (+0,+0), el resultado es (-∞,+0) y se produce FE_DIVBYZERO.
• Si z es (x,+∞) (para cualquier x finita), el resultado es (+∞,π/2).
• Si z es (x,NaN) (para cualquier x finita), el resultado es (NaN,NaN) y puede producirse FE_INVALID.
• Si z es (-∞,y) (para cualquier y finita positiva), el resultado es (+∞,π).
• Si z es (+∞,y) (para cualquier y finita positiva), el resultado es (+∞,+0).
• Si z es (-∞,+∞), el resultado es (+∞,3π/4).
• Si z es (+∞,+∞), el resultado es (+∞,π/4).
• Si z es (±∞,NaN), el resultado es (+∞,NaN).
• Si z es (NaN,y) (para cualquier y finita), el resultado es (NaN,NaN) y puede producirse FE_INVALID.
• Si z es (NaN,+∞), el resultado es (+∞,NaN).
• Si z es (NaN,NaN), el resultado es (NaN,NaN).

Notas

El logaritmo natural de un número complejo z con componentes de coordenadas polares (r,θ) es igual a ln r + i(θ+2nπ), con el valor principal ln r + iθ.

La semántica de esta función pretende ser consistente con la función C clog.

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 2597	C++98	La especificación maneja mal las partes imaginarias cero con signo.	Se eliminó el requerimiento erróneo.

Ejemplo

Ejecuta este código

#include <iostream>#include <cmath>#include <complex>   int main(){std::complex<double> z{0, 1};// r = 1, θ = pi/2std::cout<<"2*log"<< z <<" = "<<2.*std::log(z)<<'\n';   std::complex<double> z2{sqrt(2)/2, sqrt(2)/2};// r = 1, θ = pi/4std::cout<<"4*log"<< z2 <<" = "<<4.*std::log(z2)<<'\n';   std::complex<double> z3{-1, 0};// r = 1, θ = pistd::cout<<"log"<< z3 <<" = "<<std::log(z3)<<'\n';std::complex<double> z4{-1, -0.0};// el otro lado de la ramificaciónstd::cout<<"log"<< z4 <<" (el otro lado de la ramificación) = "<<std::log(z4)<<'\n';}

Salida:

2*log(0,1) = (0,3.14159) 4*log(0.707107,0.707107) = (0,3.14159) log(-1,0) = (0,3.14159) log(-1,-0) (el otro lado de la ramificación) = (0,-3.14159)

Véase también

log10(std::complex)	Logaritmo común complejo con los cortes de ramificaciones a lo largo del eje real negativo. (plantilla de función)
exp(std::complex)	Base e exponencial compleja. (plantilla de función)
loglogflogl (C++11)(C++11)	Calcula el logaritmo natural (base e) (\({\small \ln{x} }\)ln(x)) (función)
log(std::valarray)	se aplica la std::log función a cada elemento de valarray Original: applies the function std::log to each element of valarray 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 clog