_cabs

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

複素数の絶対値を計算します。

double _cabs( 
   struct _complex z 
);

パラメータ

z
複素数。

戻り値

正常に実行された場合、_cabs は引数の絶対値を返します。オーバーフローが発生した場合、_cabs は HUGE_VAL を返し、errno を ERANGE に設定します。エラー処理を変更するには、_matherr を使用します。

解説

_cabs 関数は、_complex 型の構造体で表される複素数の絶対値を計算します。z 構造体は、実数 x と虚数 y で構成されています。_cabs を呼び出すと、sqrt( z.x*z.x+z.y*z.y) 式の値と同じ値が返されます。

必要条件

ルーチン	必須ヘッダー
_cabs	<math.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

// crt_cabs.c
/* Using _cabs, this program calculates
 * the absolute value of a complex number.
 */
#include <math.h>
#include <stdio.h>

int main( void )
{
   struct _complex number = { 3.0, 4.0 };
   double d;

   d = _cabs( number );
   printf( "The absolute value of %f + %fi is %f\n",
           number.x, number.y, d );
}

The absolute value of 3.000000 + 4.000000i is 5.000000