std::sqrt(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)

 

<tbody> </tbody>

Definido en el archivo de encabezado <complex>
template< class T > complex<T> sqrt( const complex<T>& z );

Calcula la raíz cuadrada del número complejo z con un punto de ramificación a lo largo del eje real negativo.

Parámetros

z

-

El número complejo del que tomar la raíz cuadrada.

Valor de retorno

Si no se producen errores, devuelve la raíz cuadrada de z, en el rango del plano medio derecho, incluyendo el eje imaginario ([0; +∞) a lo largo del eje real y (−∞; +∞) a lo largo del eje imaginario).

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::sqrt(std::conj(z)) == std::conj(std::sqrt(z)).
• Si z es (±0,+0), el resultado de (+0,+0).
• Si z es (x,+∞), el resultado de (+∞,+∞) incluso si x es NaN.
• Si z es (x,NaN), el resultado de (NaN,NaN) (a menos que x sea ±∞) y se puede producir FE_INVALID.
• Si z es (-∞,y), el resultado de (+0,+∞) para una y finita positiva.
• Si z es (+∞,y), el resultado de (+∞,+0) para una y finita positiva.
• Si z es (-∞,NaN), el resultado de (NaN,∞) (el signo de la parte imaginaria no está especificado).
• Si z es (+∞,NaN), el resultado de (+∞,NaN).
• Si z es (NaN,y), el resultado de (NaN,NaN) y se puede producir FE_INVALID.
• Si z es (NaN,NaN), el resultado de (NaN,NaN).

Notas

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

Ejemplo

Ejecuta este código

#include <iostream>
#include <complex>

int main()
{
    std::cout << "Raíz cuadrada de -4 es "
              << std::sqrt(std::complex<double>(-4, 0)) << '\n'
              << "Raíz cuadrada de (-4,-0), el otro lado de la ramificación, es "
              << std::sqrt(std::complex<double>(-4, -0.0)) << '\n';
}

Salida:

Raíz cuadrada de -4 es (0,2)
Raíz cuadrada de (-4,-0), el otro lado de la ramificación, es (0,-2)

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.

Véase también

pow(std::complex)	Potencia compleja; uno o ambos argumentos pueden ser un número complejo. (plantilla de función)
sqrtsqrtfsqrtl (C++11)(C++11)	Calcula la raíz cuadrada (\(\small{\sqrt{x} }\)√x) (función)
sqrt(std::valarray)	Se aplica la función std::sqrt a cada elemento de valarray. (plantilla de función)
Documentación de C para csqrt