命名空间
变体
操作

csqrtf、csqrt、csqrtl

来自 cppreference.com
< c‎ | numeric‎ | complex
在头文件 <complex.h> 中定义
float complex       csqrtf( float complex z );
(1) (自 C99 起)
double complex      csqrt( double complex z );
(2) (自 C99 起)
long double complex csqrtl( long double complex z );
(3) (自 C99 起)
在头文件 <tgmath.h> 中定义
#define sqrt( z )
(4) (自 C99 起)
1-3) 计算 z 的复平方根,分支切割沿着负实轴。
4) 类型通用宏:如果 z 的类型为 long double complex,则调用 csqrtl。如果 z 的类型为 double complex,则调用 csqrt,如果 z 的类型为 float complex,则调用 csqrtf。如果 z 是实数或整数,则该宏调用相应的实数函数(sqrtfsqrtsqrtl)。如果 z 是虚数,则调用相应的复数版本。

内容

[编辑] 参数

z - 复数参数

[编辑] 返回值

如果未出现错误,则返回 z 的平方根,范围为右半平面,包括虚轴([0; +∞) 沿着实轴,(−∞; +∞) 沿着虚轴)。

[编辑] 错误处理和特殊值

错误报告与 math_errhandling 一致

如果实现支持 IEEE 浮点数算术,则

  • 该函数连续到分支切割,考虑到虚部的符号
  • csqrt(conj(z)) == conj(csqrt(z))
  • 如果 z±0+0i,则结果为 +0+0i
  • 如果 zx+∞i,则结果为 +∞+∞i,即使 x 是 NaN
  • 如果 zx+NaNi,则结果为 NaN+NaNi(除非 x 为 ±∞),并且可能引发 FE_INVALID
  • 如果 z-∞+yi,则结果为 +0+∞i,对于有限的正 y
  • 如果 z+∞+yi,则结果为 +∞+0i),对于有限的正 y
  • 如果 z-∞+NaNi,则结果为 NaN±∞i(虚部的符号未指定)
  • 如果 z+∞+NaNi,则结果为 +∞+NaNi
  • 如果 zNaN+yi,则结果为 NaN+NaNi,并且可能引发 FE_INVALID
  • 如果 zNaN+NaNi,则结果为 NaN+NaNi

[编辑] 示例

#include <stdio.h>
#include <complex.h>
 
int main(void)
{
    double complex z1 = csqrt(-4);
    printf("Square root of -4 is %.1f%+.1fi\n", creal(z1), cimag(z1));
 
    double complex z2 = csqrt(conj(-4)); // or, in C11, CMPLX(-4, -0.0)
    printf("Square root of -4-0i, the other side of the cut, is "
           "%.1f%+.1fi\n", creal(z2), cimag(z2));
}

输出

Square root of -4 is 0.0+2.0i
Square root of -4-0i, the other side of the cut, is 0.0-2.0i

[编辑] 参考文献

  • C11 标准(ISO/IEC 9899:2011)
  • 7.3.8.3 csqrt 函数(p: 196)
  • 7.25 类型通用数学 <tgmath.h>(p: 373-375)
  • G.6.4.2 csqrt 函数(p: 544)
  • G.7 类型通用数学 <tgmath.h>(p: 545)
  • C99 标准(ISO/IEC 9899:1999)
  • 7.3.8.3 csqrt 函数(p: 178)
  • 7.22 类型通用数学 <tgmath.h>(p: 335-337)
  • G.6.4.2 csqrt 函数(p: 479)
  • G.7 类型通用数学 <tgmath.h>(p: 480)

[编辑] 另请参见

(C99)(C99)(C99)
计算复幂函数
(函数) [编辑]
(C99)(C99)
计算平方根(x
(函数) [编辑]
C++ 文档 for sqrt