_cabs

[アーティクル]
08/09/2011

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

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 );
}