.\" 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 2017\-09\-15 "" "Linux Programmer's Manual"
.SH 名前
carg, cargf, cargl \- 複素数の偏角を計算する
.SH 書式
\fB#include <complex.h>\fP
.PP
\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
.PP
\fI\-lm\fP でリンクする。
.SH 説明
これらの関数は、 \fIz\fP の複素引数 (位相角とも呼ばれる) を計算する。実軸の負の部分に沿って分枝切断 (branch cut) がある)。
.PP
複素数は 2つの実数値からなる座標で表すことができる。 直交座標を使うと、以下のように書くことができる。
.PP
.nf
    z = x + I * y
.fi
.PP
ここで、\fIx\ =\ creal(z)\fP, \fIy\ =\ cimag(z)\fP である。
.PP
また、極座標を使うと、以下のように書くことができる。
.PP
.nf
    z = r * cexp(I * a)
.fi
.PP
ここで、 \fIr\ =\ cabs(z)\fP は「半径」、「係数」であり、 \fIz\fP の絶対値である。 \fIa\ =\ carg(z)\fP
は「位相角」であり、 \fIz\fP の偏角である。
.PP
次の関係が成立する:
.PP
.nf
    tan(carg(z)) = cimag(z) / creal(z)
.fi
.SH 返り値
返り値は [\-pi,pi] の範囲である。
.SH バージョン
これらの関数は glibc バージョン 2.1 で初めて登場した。
.SH 属性
この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。
.TS
allbox;
lbw24 lb lb
l l l.
インターフェース	属性	値
T{
\fBcarg\fP(),
\fBcargf\fP(),
\fBcargl\fP()
T}	Thread safety	MT\-Safe
.TE
.SH 準拠
C99, POSIX.1\-2001, POSIX.1\-2008.
.SH 関連項目
\fBcabs\fP(3), \fBcomplex\fP(7)
.SH この文書について
この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は
\%https://www.kernel.org/doc/man\-pages/ に書かれている。