_Imaginary_I

 

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> で定義
#define _Imaginary_I /* 未指定 */		(C99以降)

_Imaginary_I マクロは、虚数単位の値を持つ const float _Imaginary 型の値に展開されます。

Cにおける純虚数サポートと同様に、このマクロは虚数サポートが有効な場合にのみ定義されます。

コンパイラは、__STDC_IEC_559_COMPLEX__ を定義していても、虚数サポートを必要とするわけではありません。POSIX は、虚数サポートを識別するためにマクロ _Imaginary_I が定義されているかを確認することを推奨しています。	(C99以降) (C11まで)
虚数サポートは、__STDC_IEC_559_COMPLEX__ が定義されている場合にサポートされます。	(C11 以降)

注意

このマクロにより、実数部と虚数部から複素数を正確に組み立てることができます。例えば、(double complex)((double)x + _Imaginary_I * (double)y) のようになります。このパターンは C11 でマクロ CMPLX として標準化されました。もし _Complex_I を代わりに使用した場合、この式は虚数部で負のゼロを正のゼロに変換することが許可されます。

例

このコードを実行

#include <stdio.h>
#include <complex.h>
#include <math.h>
 
int main(void)
{
    double complex z1 = 0.0 + INFINITY * _Imaginary_I;
    printf("z1 = %.1f%+.1fi\n", creal(z1), cimag(z1));
 
    double complex z2 = 0.0 + INFINITY * _Complex_I;
    printf("z2 = %.1f%+.1fi\n", creal(z2), cimag(z2));
}

出力

z1 = 0.0+Infi 
z2 = NaN+Infi

参考文献

• C11標準 (ISO/IEC 9899:2011)

• 7.3.1/5 _Imaginary_I (p: 188)

• G.6/1 _Imaginary_I (p: 537)

• C99標準 (ISO/IEC 9899:1999)

• 7.3.1/3 _Imaginary_I (p: 170)

• G.6/1 _Imaginary_I (p: 472)

関連項目

_Complex_I (C99)	複素数単位定数 i (マクロ定数)
I (C99)	複素数または虚数単位定数 i (マクロ定数)