OSDN Git Service

(split) LDP: Update releases based on LDP 3.52 release
[linuxjm/LDP_man-pages.git] / release / man3 / catanh.3
index 03125f5..3bb2133 100644 (file)
@@ -1,51 +1,74 @@
 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
+.\" and Copyright (C) 2011 Michael Kerrisk <mtk.manpages@gamil.com>
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
 .\" Distributed under GPL
+.\" %%%LICENSE_END
 .\"
-.\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
-.\"         all rights reserved.
-.\" Translated Thu Jul 24 00:43:35 JST 2003
-.\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"*******************************************************************
 .\"
-.\"WORD:       hyperbolic      ÁжÊ(Àþ¤Î)
-.\"WORD:       arc sine        µÕÀµ¸¹
-.\"WORD:       arc cosine      µÕ;¸¹
-.\"WORD:       arc tangent     µÕÀµÀÜ
-.\"WORD:       real part       ¼ÂÉô
-.\"WORD:       imaginary part  µõÉô
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH CATANH 3 2008-08-06 "" "Linux Programmer's Manual"
-.SH Ì¾Á°
-catanh, catanhf, catanhl \- Ê£ÁÇ¿ô¤ÎµÕÁжÊÀþÀµÀÜ (arc tangents hyperbolic)
-.SH ½ñ¼°
-.B #include <complex.h>
+.\"*******************************************************************
+.TH CATANH 3 2011\-09\-15 "" "Linux Programmer's Manual"
+.SH 名前
+catanh, catanhf, catanhl \- 複素数の逆双曲線正接 (arc tangents hyperbolic)
+.SH 書式
+\fB#include <complex.h>\fP
 .sp
-.BI "double complex catanh(double complex " z );
+\fBdouble complex catanh(double complex \fP\fIz\fP\fB);\fP
 .br
-.BI "float complex catanhf(float complex " z );
+\fBfloat complex catanhf(float complex \fP\fIz\fP\fB);\fP
 .br
-.BI "long double complex catanhl(long double complex " z );
+\fBlong double complex catanhl(long double complex \fP\fIz\fP\fB);\fP
 .sp
-\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
-.SH ÀâÌÀ
-.BR catanh ()
-´Ø¿ô¤ÏÊ£ÁÇ¿ô
-.I z
-¤ÎµÕÁжÊÀþÀµ¸¹ (arc hyperbolic tangent) ¤ò·×»»¤¹¤ë¡£
-\fIy = catanh(z)\fP ¤Ê¤é¤Ð¡¢ \fIz = ctanh(y)\fP ¤¬À®Î©¤¹¤ë¡£
-.I y
-¤ÎµõÉô¤ÎÃͤ϶è´Ö [\-pi/2,pi/2] ¤«¤éÁªÂò¤µ¤ì¤ë¡£
+\fI\-lm\fP でリンクする。
+.SH 説明
+\fBcatanh\fP()  関数は複素数 \fIz\fP の逆双曲線正弦 (arc hyperbolic tangent) を計算する。 \fIy =
+catanh(z)\fP ならば、 \fIz = ctanh(y)\fP が成立する。 \fIy\fP の虚部の値は区間 [\-pi/2,pi/2] から選択される。
 .LP
-¼¡¤Î´Ø·¸¤¬À®Î©¤¹¤ë:
+次の関係が成立する:
 .nf
 
-    catanh(z) = 0.5 * clog((1 + z) / (1 \- z))
+    catanh(z) = 0.5 * (clog(1 + z) \- clog(1 \- z))
 .fi
-.SH ¥Ð¡¼¥¸¥ç¥ó
-¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 ¤Ç½é¤á¤ÆÅо줷¤¿¡£
-.SH ½àµò
+.SH バージョン
+これらの関数は glibc バージョン 2.1 で初めて登場した。
+.SH 準拠
 C99.
-.SH ´ØÏ¢¹àÌÜ
-.BR atanh (3),
-.BR cabs (3),
-.BR cimag (3),
-.BR complex (7)
+.SH 例
+.nf
+/* "\-lm" でリンクする */
+
+#include <complex.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <stdio.h>
+
+int
+main(int argc, char *argv[])
+{
+    double complex z, c, f;
+
+    if (argc != 3) {
+        fprintf(stderr, "Usage: %s <real> <imag>\en", argv[0]);
+        exit(EXIT_FAILURE);
+    }
+
+    z = atof(argv[1]) + atof(argv[2]) * I;
+
+    c = catanh(z);
+    printf("catanh() = %6.3f %6.3f*i\en", creal(c), cimag(c));
+
+    f = 0.5 * (clog(1 + z) \- clog(1 \- z));
+    printf("formula  = %6.3f %6.3f*i\en", creal(f2), cimag(f2));
+
+    exit(EXIT_SUCCESS);
+}
+.fi
+.SH 関連項目
+\fBatanh\fP(3), \fBcabs\fP(3), \fBcimag\fP(3), \fBctanh\fP(3), \fBcomplex\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。