csqrtf, csqrt, csqrtl
来自cppreference.com
在标头 <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 标准(ISO/IEC 9899:2011):
- 7.3.8.3 The csqrt functions (第 196 页)
- 7.25 Type-generic math <tgmath.h> (第 373-375 页)
- G.6.4.2 The csqrt functions (第 544 页)
- G.7 Type-generic math <tgmath.h> (第 545 页)
- C99 标准(ISO/IEC 9899:1999):
- 7.3.8.3 The csqrt functions (第 178 页)
- 7.22 Type-generic math <tgmath.h> (第 335-337 页)
- G.6.4.2 The csqrt functions (第 479 页)
- G.7 Type-generic math <tgmath.h> (第 480 页)
参阅
(C99)(C99)(C99) |
计算复数幂函数 (函数) |
(C99)(C99) |
计算平方根(√x) (函数) |