.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" Distributed under GPL
.\" %%%LICENSE_END
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
.\"         all rights reserved.
.\" Translated 2003-07-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2005-10-02, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
.TH CARG 3 2008\-08\-11 "" "Linux Programmer's Manual"
.SH 名前
carg, cargf, cargl \- 複素数の偏角を計算する
.SH 書式
\fB#include <complex.h>\fP
.sp
\fBdouble carg(double complex \fP\fIz\fP\fB);\fP
.br
\fBfloat cargf(float complex \fP\fIz\fP\fB);\fP
.br
\fBlong double cargl(long double complex \fP\fIz\fP\fB);\fP
.sp
\fI\-lm\fP でリンクする。
.SH 説明
複素数は 2つの実数値からなる座標で表すことができる。 直交座標を使うと、以下のように書くことができる。

.nf
    z = x + I * y
.fi

ここで、\fIx\ =\ creal(z)\fP, \fIy\ =\ cimag(z)\fP である。
.LP
また、極座標を使うと、以下のように書くことができる。
.nf

    z = r * cexp(I * a)

.fi
ここで、 \fIr\ =\ cabs(z)\fP は「半径」、「係数」であり、 \fIz\fP の絶対値である。 \fIa\ =\ carg(z)\fP
は「位相角」であり、 \fIz\fP の偏角である。
.LP
次の関係が成立する:
.nf

    tan(carg(z)) = cimag(z) / creal(z)
.fi
.SH 返り値
返り値は [\-pi,pi] の範囲である。
.SH バージョン
これらの関数は glibc バージョン 2.1 で初めて登場した。
.SH 準拠
C99.
.SH 関連項目
\fBcabs\fP(3), \fBcomplex\fP(7)
.SH この文書について
この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。