cimag、 cimagf、 cimagl

複素数の虚数部を取得します。

構文

double cimag( _Dcomplex z );
float cimagf( _Fcomplex z );
long double cimagl( _Lcomplex z );
#define cimag(X) // Requires C11 or higher

float cimag( _Fcomplex z );  // C++ only
long double cimag( _Lcomplex z );  // C++ only

パラメーター

z
複素数。

戻り値

z の虚数部。

解説

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

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

要件

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

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

関連項目

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