draft/man3/carg.3

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