carg、 cargf、 cargl

負の実数軸に沿って分岐切断線を使用して、複素数の引数を取得します。

構文

double carg(
   _Dcomplex z
);
float carg(
   _Fcomplex z
);  // C++ only
long double carg(
   _Lcomplex z
);  // C++ only
float cargf(
   _Fcomplex z
);
long double cargl(
   _Lcomplex z
);
#define carg(X) // Requires C11 or higher

パラメーター

z
複素数。

戻り値

z の引数 (フェーズとも呼ばれます)。 結果は [-π, +π] の区間内になります。

解説

C++ ではオーバーロードが可能であるため、_Fcomplex または _Lcomplex の値を受け取って float または long double の値を返す carg のオーバーロードを呼び出すことができます。 C プログラムでは、 <tgmath.h> マクロを使用してこの関数を呼び出す場合を除き、 carg は常に _Dcomplex 値を受け取り、 double 値を返します。

<tgmath.h>carg() マクロを使用する場合は、引数の型によって、この関数のどのバージョンが選択されるかが決定されます。 詳細については、「ジェネリック型数値演算」を参照してください。

要件

ルーチンによって返される値	C ヘッダー	C++ ヘッダー
carg、 cargf、 cargl	<complex.h>	<ccomplex>
carg マクロ	<tgmath.h>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

関数リファレンス (アルファベット順)
norm、 normf、 norml
creal、 crealf、 creall
cproj、 cprojf、 cprojl
conj、 conjf、 conjl
cimag、 cimagf、 cimagl
cabs、 cabsf、 cabsl