draft/man3/carg.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\"
   4 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
   5 .\"         all rights reserved.
   6 .\" Translated 2003-07-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   7 .\" Updated 2005-10-02, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   8 .\"
   9 .\"WORD:        argument        (極座標の)偏角
  10 .\"WORD:        coordinates     座標
  11 .\"WORD:        rectangular coordinates 直交座標
  12 .\"WORD:        polar coordinates       極座標
  13 .\"
  14 .TH CARG 3 2008-08-06 "" "Linux Programmer's Manual"
  15 .\"O .SH NAME
  16 .SH 名前
  17 .\"O carg, cargf, cargl \- calculate the complex argument
  18 carg, cargf, cargl \- 複素数の偏角を計算する
  19 .\"O .SH SYNOPSIS
  20 .SH 書式
  21 .B #include <complex.h>
  22 .sp
  23 .BI "double carg(double complex " z ");"
  24 .br
  25 .BI "float cargf(float complex " z ");"
  26 .br
  27 .BI "long double cargl(long double complex " z ");"
  28 .sp
  29 .\"O Link with \fI\-lm\fP.
  30 \fI\-lm\fP でリンクする。
  31 .\"O .SH DESCRIPTION
  32 .SH 説明
  33 .\"O A complex number can be described by two real coordinates.
  34 .\"O One may use rectangular coordinates and gets
  35 .\"O
  36 .\"O .nf
  37 .\"O     z = x + I * y
  38 .\"O .fi
  39 .\"O
  40 .\"O where \fIx\ =\ creal(z)\fP and \fIy\ =\ cimag(z)\fP.
  41 複素数は 2つの実数値からなる座標で表すことができる。
  42 直交座標を使うと、以下のように書くことができる。
  43
  44 .nf
  45     z = x + I * y
  46 .fi
  47
  48 ここで、\fIx\ =\ creal(z)\fP, \fIy\ =\ cimag(z)\fP である。
  49 .LP
  50 .\"O Or one may use polar coordinates and gets
  51 .\"O .nf
  52 .\"O
  53 .\"O     z = r * cexp(I * a)
  54 .\"O
  55 .\"O .fi
  56 .\"O where \fIr\ =\ cabs(z)\fP
  57 .\"O is the "radius", the "modulus", the absolute value of \fIz\fP, and
  58 .\"O \fIa\ =\ carg(z)\fP
  59 .\"O is the "phase angle", the argument of \fIz\fP.
  60 また、極座標を使うと、以下のように書くことができる。
  61 .nf
  62
  63     z = r * cexp(I * a)
  64
  65 .fi
  66 ここで、
  67 \fIr\ =\ cabs(z)\fP は「半径」、「係数」であり、
  68 \fIz\fP の絶対値である。
  69 \fIa\ =\ carg(z)\fP は「位相角」であり、
  70 \fIz\fP の偏角である。
  71 .LP
  72 .\"O One has:
  73 次の関係が整理する:
  74 .nf
  75
  76     tan(carg(z)) = cimag(z) / creal(z)
  77 .fi
  78 .\"O .SH "RETURN VALUE"
  79 .SH 返り値
  80 .\"O The return value is the range of [\-pi,pi].
  81 返り値は [\-pi,pi] の範囲である。
  82 .\"O .SH VERSIONS
  83 .SH バージョン
  84 .\"O These functions first appeared in glibc in version 2.1.
  85 これらの関数は glibc バージョン 2.1 で初めて登場した。
  86 .\"O .SH "CONFORMING TO"
  87 .SH 準拠
  88 C99.
  89 .\"O .SH "SEE ALSO"
  90 .SH 関連項目
  91 .BR cabs (3),
  92 .BR complex (7)