manual/LDP_man-pages/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 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)