release/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 .\"
  13 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
  14 .\"         all rights reserved.
  15 .\" Translated 2003-07-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  16 .\" Updated 2005-10-02, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  17 .\"
  18 .TH CARG 3 2008\-08\-11 "" "Linux Programmer's Manual"
  19 .SH 名前
  20 carg, cargf, cargl \- 複素数の偏角を計算する
  21 .SH 書式
  22 \fB#include <complex.h>\fP
  23 .sp
  24 \fBdouble carg(double complex \fP\fIz\fP\fB);\fP
  25 .br
  26 \fBfloat cargf(float complex \fP\fIz\fP\fB);\fP
  27 .br
  28 \fBlong double cargl(long double complex \fP\fIz\fP\fB);\fP
  29 .sp
  30 \fI\-lm\fP でリンクする。
  31 .SH 説明
  32 複素数は 2つの実数値からなる座標で表すことができる。 直交座標を使うと、以下のように書くことができる。
  33
  34 .nf
  35     z = x + I * y
  36 .fi
  37
  38 ここで、\fIx\ =\ creal(z)\fP, \fIy\ =\ cimag(z)\fP である。
  39 .LP
  40 また、極座標を使うと、以下のように書くことができる。
  41 .nf
  42
  43     z = r * cexp(I * a)
  44
  45 .fi
  46 ここで、 \fIr\ =\ cabs(z)\fP は「半径」、「係数」であり、 \fIz\fP の絶対値である。 \fIa\ =\ carg(z)\fP
  47 は「位相角」であり、 \fIz\fP の偏角である。
  48 .LP
  49 次の関係が成立する:
  50 .nf
  51
  52     tan(carg(z)) = cimag(z) / creal(z)
  53 .fi
  54 .SH 返り値
  55 返り値は [\-pi,pi] の範囲である。
  56 .SH バージョン
  57 これらの関数は glibc バージョン 2.1 で初めて登場した。
  58 .SH 準拠
  59 C99.
  60 .SH 関連項目
  61 \fBcabs\fP(3), \fBcomplex\fP(7)
  62 .SH この文書について
  63 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
  64 である。プロジェクトの説明とバグ報告に関する情報は
  65 http://www.kernel.org/doc/man\-pages/ に書かれている。