draft/man3/clog.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 Thu Jul 24 01:47:42 JST 2003
   7 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   8 .\"
   9 .\"WORD:        natural logarithm       自然対数
  10 .\"WORD:        logarithm               対数
  11 .\"WORD:        exponential             指数
  12 .\"WORD:        inverse function        逆関数
  13 .\"
  14 .TH CLOG 3 2008-08-11 "" "Linux Programmer's Manual"
  15 .\"O .SH NAME
  16 .SH 名前
  17 .\"O clog, clogf, clogl \- natural logarithm of a complex number
  18 clog, clogf, clogl \- 複素数の自然対数
  19 .\"O .SH SYNOPSIS
  20 .SH 書式
  21 .B #include <complex.h>
  22 .sp
  23 .BI "double complex clog(double complex " z );
  24 .br
  25 .BI "float complex clogf(float complex " z );
  26 .br
  27 .BI "long double complex clogl(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 The logarithm
  34 .\"O .BR clog ()
  35 .\"O is the inverse function of the exponential
  36 .\"O .BR cexp (3).
  37 .\"O Thus, if \fIy = clog(z)\fP, then \fIz = cexp(y)\fP.
  38 .\"O The imaginary part of
  39 .\"O .I y
  40 .\"O is chosen in the interval [\-pi,pi].
  41 対数
  42 .BR clog ()
  43 は指数関数
  44 .BR cexp ()
  45 の逆関数である。
  46 したがって、 \fIy = clog(z)\fP ならば、 \fIz = cexp(y)\fP が成立する。
  47 .I y
  48 の虚数部の値は区間 [\-pi,pi] から選択される。
  49 .LP
  50 .\"O One has:
  51 次の関係が成立する:
  52 .nf
  53
  54     clog(z) = log(cabs(z)) + I * carg(z)
  55 .fi
  56 .LP
  57 .\"O Note that
  58 .\"O .I z
  59 .\"O close to zero will cause an overflow.
  60 .I z
  61 として 0 に近い値を入れると、オーバーフローを起こすため、
  62 注意が必要である。
  63 .\"O .SH VERSIONS
  64 .SH バージョン
  65 .\"O These functions first appeared in glibc in version 2.1.
  66 これらの関数は glibc バージョン 2.1 で初めて登場した。
  67 .\"O .SH "CONFORMING TO"
  68 .SH 準拠
  69 C99.
  70 .\"O .SH "SEE ALSO"
  71 .SH 関連項目
  72 .BR cabs (3),
  73 .BR cexp (3),
  74 .BR clog10 (3),
  75 .BR clog2 (3),
  76 .BR complex (7)