release/man3/carg.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\"
   4 .\"*******************************************************************
   5 .\"
   6 .\" This file was generated with po4a. Translate the source file.
   7 .\"
   8 .\"*******************************************************************
   9 .TH CARG 3 2008\-08\-11 "" "Linux Programmer's Manual"
  10 .SH 名前
  11 carg, cargf, cargl \- 複素数の偏角を計算する
  12 .SH 書式
  13 \fB#include <complex.h>\fP
  14 .sp
  15 \fBdouble carg(double complex \fP\fIz\fP\fB);\fP
  16 .br
  17 \fBfloat cargf(float complex \fP\fIz\fP\fB);\fP
  18 .br
  19 \fBlong double cargl(long double complex \fP\fIz\fP\fB);\fP
  20 .sp
  21 \fI\-lm\fP でリンクする。
  22 .SH 説明
  23 複素数は 2つの実数値からなる座標で表すことができる。 直交座標を使うと、以下のように書くことができる。
  24
  25 .nf
  26     z = x + I * y
  27 .fi
  28
  29 ここで、\fIx\ =\ creal(z)\fP, \fIy\ =\ cimag(z)\fP である。
  30 .LP
  31 また、極座標を使うと、以下のように書くことができる。
  32 .nf
  33
  34     z = r * cexp(I * a)
  35
  36 .fi
  37 ここで、 \fIr\ =\ cabs(z)\fP は「半径」、「係数」であり、 \fIz\fP の絶対値である。 \fIa\ =\ carg(z)\fP
  38 は「位相角」であり、 \fIz\fP の偏角である。
  39 .LP
  40 次の関係が成立する:
  41 .nf
  42
  43     tan(carg(z)) = cimag(z) / creal(z)
  44 .fi
  45 .SH 返り値
  46 返り値は [\-pi,pi] の範囲である。
  47 .SH バージョン
  48 これらの関数は glibc バージョン 2.1 で初めて登場した。
  49 .SH 準拠
  50 C99.
  51 .SH 関連項目
  52 \fBcabs\fP(3), \fBcomplex\fP(7)