csqrtf, csqrt, csqrtl

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数运算 (C99)

类型通用数学 (C99)

位操作 (C23)

检查整数运算 (C23)

 

复数运算

类型和虚数常量
complex (C99) _Complex_I (C99)     CMPLX (C11)	imaginary (C99) _Imaginary_I (C99) I (C99)
操作
cimag (C99) creal (C99) carg (C99)	cabs (C99) conj (C99) cproj (C99)
幂函数和指数函数
cexp (C99) clog (C99)	cpow (C99) csqrt (C99)
三角函数
ccos (C99) csin (C99) ctan (C99)	cacos (C99) casin (C99) catan (C99)
双曲函数
ccosh (C99) csinh (C99) ctanh (C99)	cacosh (C99) casinh (C99) catanh (C99)

 

定义在头文件 <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 是实数或整数，则宏调用相应的实数函数（sqrtf、sqrt、sqrtl）。如果 z 是虚数，则调用相应的复数版本。

参数

z

-

复数参数

返回值

如果未发生错误，则返回 z 的平方根，其范围在右半平面内，包括虚轴（沿实轴为 [0; +∞)，沿虚轴为 (−∞; +∞)）。

错误处理和特殊值

错误按照 math_errhandling 报告

如果实现支持 IEEE 浮点算术，

• 函数在分支切割上是连续的，并考虑虚部的符号
• csqrt(conj(z)) == conj(csqrt(z))
• 如果 z 是 ±0+0i，结果是 +0+0i
• 如果 z 是 x+∞i，即使 x 是 NaN，结果也是 +∞+∞i
• 如果 z 是 x+NaNi，结果是 NaN+NaNi（除非 x 是 ±∞），并且可能引发 FE_INVALID
• 如果 z 是 -∞+yi，对于有限正数 y，结果是 +0+∞i
• 如果 z 是 +∞+yi，对于有限正数 y，结果是 +∞+0i)
• 如果 z 是 -∞+NaNi，结果是 NaN±∞i（虚部的符号未指定）
• 如果 z 是 +∞+NaNi，结果是 +∞+NaNi
• 如果 z 是 NaN+yi，结果是 NaN+NaNi，并且可能引发 FE_INVALID
• 若 z 为 NaN+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)

另请参见

cpowcpowfcpowl (C99)(C99)(C99)	计算复数幂函数 (函数)
sqrtsqrtfsqrtl (C99)(C99)	计算平方根 (\(\small{\sqrt{x} }\)√x) (函数)
C++ 文档 用于 sqrt