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 ） (函数) |