OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / draft / man3 / cacosh.3
index 37b701e..5c409ce 100644 (file)
@@ -1,75 +1,80 @@
 .\" 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
+.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
 .\"
 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
 .\"         all rights reserved.
 .\" Translated Thu Jul 24 00:26:52 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  µõÉô
-.\"
-.TH CACOSH 3 2008-08-06 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O cacosh, cacoshf, cacoshl \- complex arc hyperbolic cosine
-cacosh, cacoshf, cacoshl \- Ê£ÁÇ¿ô¤ÎµÕÁжÊÀþ;¸¹ (arc hyperbolic cosine)
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <complex.h>
+.TH CACOSH 3 2011\-09\-15 "" "Linux Programmer's Manual"
+.SH 名前
+cacosh, cacoshf, cacoshl \- 複素数の逆双曲線余弦 (arc hyperbolic cosine)
+.SH 書式
+\fB#include <complex.h>\fP
 .sp
-.BI "double complex cacosh(double complex " z );
+\fBdouble complex cacosh(double complex \fP\fIz\fP\fB);\fP
 .br
-.BI "float complex cacoshf(float complex " z );
+\fBfloat complex cacoshf(float complex \fP\fIz\fP\fB);\fP
 .br
-.BI "long double complex cacoshl(long double complex " z );
+\fBlong double complex cacoshl(long double complex \fP\fIz\fP\fB);\fP
 .sp
-.\"O Link with \fI\-lm\fP.
-\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR cacosh ()
-.\"O function calculates the complex arc hyperpolic cosine of
-.\"O .IR z .
-.\"O If \fIy\ =\ cacosh(z)\fP, then \fIz\ =\ ccosh(y)\fP.
-.\"O The imaginary part of
-.\"O .I y
-.\"O is chosen in the interval [\-pi,pi].
-.\"O The real part of
-.\"O .I y
-.\"O is chosen nonnegative.
-.BR cacosh ()
-´Ø¿ô¤ÏÊ£ÁÇ¿ô
-.I z
-¤ÎµÕÁжÊÀþ;¸¹ (arc hyperbolic cosine) ¤ò·×»»¤¹¤ë¡£
-\fIy\ =\ cacosh(z)\fP ¤Ê¤é¤Ð¡¢
-\fIz\ =\ ccosh(y)\fP ¤¬À®Î©¤¹¤ë¡£
-.I y
-¤ÎµõÉô¤ÎÃͤ϶è´Ö [\-pi,pi] ¤«¤éÁªÂò¤µ¤ì¡¢
-.I y
-¤Î¼ÂÉô¤ÎÃͤÏÈóÉé¤ÎÃͤ¬ÁªÂò¤µ¤ì¤ë¡£
+\fI\-lm\fP でリンクする。
+.SH 説明
+\fBcacosh\fP()  関数は複素数 \fIz\fP の逆双曲線余弦 (arc hyperbolic cosine) を計算する。 \fIy\ =\ cacosh(z)\fP ならば、 \fIz\ =\ ccosh(y)\fP が成立する。 \fIy\fP の虚部の値は区間 [\-pi,pi] から選択され、 \fIy\fP
+の実部の値は非負の値が選択される。
 .LP
-.\"O One has:
-¼¡¤Î´Ø·¸¤¬À®Î©¤¹¤ë:
+次の関係が成立する:
 .nf
 
-    cacosh(z) = (0.5) * clog((1 + z) / (1 \- z))
+    cacosh(z) = 2 * clog(csqrt((z + 1) / 2) + csqrt((z \- 1) / 2))
 .fi
-.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
-.\"O These functions first appeared in glibc in version 2.1.
-¤³¤ì¤é¤Î´Ø¿ô¤Ï glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 ¤Ç½é¤á¤ÆÅо줷¤¿¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH バージョン
+これらの関数は glibc バージョン 2.1 で初めて登場した。
+.SH 準拠
 C99.
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR acosh (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 = cacosh(z);
+    printf("cacosh() = %6.3f %6.3f*i\en", creal(c), cimag(c));
+
+    f = 2 * clog(csqrt((z + 1)/2) + csqrt((z \- 1)/2));
+    printf("formula  = %6.3f %6.3f*i\en", creal(f2), cimag(f2));
+
+    exit(EXIT_SUCCESS);
+}
+.fi
+.SH 関連項目
+\fBacosh\fP(3), \fBcabs\fP(3), \fBccosh\fP(3), \fBcimag\fP(3), \fBcomplex\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。