C 参考手册
- C 语言
- C 关键词
- 预处理器
- C 标准库头文件
- 类型支持
- 程序支持工具
- 变参数函数
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 算法
- 数值
- 常用数学函数
- 浮点环境
- 伪随机数生成
- 复数算术
- complex
- imaginary
- _Complex_I
- CMPLXF, CMPLX, CMPLXL
- _Imaginary_I
- I
- cimagf, cimag, cimagl
- crealf, creal, creall
- cargf, carg, cargl
- cabsf, cabs, cabsl
- conjf, conj, conjl
- cprojf, cproj, cprojl
- cexpf, cexp, cexpl
- clogf, clog, clogl
- cpowf, cpow, cpowl
- csqrtf, csqrt, csqrtl
- ccosf, ccos, ccosl
- csinf, csin, csinl
- ctanf, ctan, ctanl
- cacosf, cacos, cacosl
- casinf, casin, casinl
- catanf, catan, catanl
- ccoshf, ccosh, ccoshl
- csinhf, csinh, csinhl
- ctanhf, ctanh, ctanhl
- cacoshf, cacosh, cacoshl
- casinhf, casinh, casinhl
- catanhf, catanh, catanhl
- 泛型数学
- 文件输入/输出
- 本地化支持
- 原子操作库
- 线程支持库
- 实验性 C 标准库
- 有用的资源
- 符号索引
- 注释
csqrtf, csqrt, csqrtl
定义于头文件 <complex.h>
|
||
(1) | (C99 起) | |
(2) | (C99 起) | |
(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
,则结果为+∞+∞i
,即使 x 为 NaN - 若
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)); // 或 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 standard (ISO/IEC 9899:2011):
- 7.3.8.3 The csqrt functions (p: 196)
- 7.25 Type-generic math <tgmath.h> (p: 373-375)
- G.6.4.2 The csqrt functions (p: 544)
- G.7 Type-generic math <tgmath.h> (p: 545)
- C99 standard (ISO/IEC 9899:1999):
- 7.3.8.3 The csqrt functions (p: 178)
- 7.22 Type-generic math <tgmath.h> (p: 335-337)
- G.6.4.2 The csqrt functions (p: 479)
- G.7 Type-generic math <tgmath.h> (p: 480)
参阅
(C99)(C99)(C99) |
计算复数幂函数 (函数) |
(C99)(C99) |
计算平方根( √x ) (函数) |