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