OSDN Git Service

(split) LDP: Update release pages based on LDP 3.54 release
[linuxjm/LDP_man-pages.git] / release / man3 / atanh.3
index ae5691d..b937818 100644 (file)
@@ -2,6 +2,7 @@
 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -21,6 +22,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\" Modified 2002-07-27 by Walter Harms
 .\"    (walter.harms@informatik.uni-oldenburg.de)
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 1996 Kenji Kajiwara and Kentaro Ogawa
 .\"         all rights reserved.
 .\" Translated Sat, 13 Jul 1996 17:58:16 JST
 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\" Updated 2008-09-14, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
-.TH ATANH 3  2010-09-11 "" "Linux Programmer's Manual"
-.SH Ì¾Á°
-atanh, atanhf, atanhl \- µÕÁжÊÀþÀµÀÜ¡Êinverse hyperbolic tangent¡Ë´Ø¿ô
-.SH ½ñ¼°
+.TH ATANH 3 2010\-09\-11 "" "Linux Programmer's Manual"
+.SH 名前
+atanh, atanhf, atanhl \- 逆双曲線正接(inverse hyperbolic tangent)関数
+.SH 書式
 .nf
-.B #include <math.h>
+\fB#include <math.h>\fP
 .sp
-.BI "double atanh(double " x );
+\fBdouble atanh(double \fP\fIx\fP\fB);\fP
 .br
-.BI "float atanhf(float " x );
+\fBfloat atanhf(float \fP\fIx\fP\fB);\fP
 .br
-.BI "long double atanhl(long double " x );
+\fBlong double atanhl(long double \fP\fIx\fP\fB);\fP
 .sp
 .fi
-\fI\-lm\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
+\fI\-lm\fP でリンクする。
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
 .ad l
-.BR atanh ():
+\fBatanh\fP():
 .RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
+_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L;
 .br
-or
-.I cc\ -std=c99
+or \fIcc\ \-std=c99\fP
 .RE
 .br
-.BR atanhf (),
-.BR atanhl ():
+\fBatanhf\fP(), \fBatanhl\fP():
 .RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
+_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE
+|| _POSIX_C_SOURCE\ >=\ 200112L;
 .br
-or
-.I cc\ -std=c99
+or \fIcc\ \-std=c99\fP
 .RE
 .ad b
-.SH ÀâÌÀ
-.BR atanh ()
-´Ø¿ô¤Ï \fIx\fP ¤ÎµÕÁжÊÀþÀµÀÜ (inverse hyperbolic tangent) ¤ò·×»»¤¹¤ë¡£
-¤¹¤Ê¤ï¤Á¡¢¤½¤ÎÁжÊÀþÀµÀÜ (hyperbolic tangent) ¤¬ \fIx\fP ¤Ë¤Ê¤ë
-¤è¤¦¤ÊÃͤǤ¢¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï
-.I x
-¤ÎµÕÁжÊÀþÀµÀܤòÊÖ¤¹¡£
+.SH 説明
+\fBatanh\fP()  関数は \fIx\fP の逆双曲線正接 (inverse hyperbolic tangent) を計算する。
+すなわち、その双曲線正接 (hyperbolic tangent) が \fIx\fP になる ような値である。
+.SH 返り値
+成功すると、これらの関数は \fIx\fP の逆双曲線正接を返す。
 
-.I x
-¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が NaN の場合、NaN が返される。
 
-.I x
-¤¬ +0 (\-0) ¤Î¾ì¹ç¡¢+0 (\-0) ¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が +0 (\-0) の場合、+0 (\-0) が返される。
 
-.I x
-¤¬ +1 ¤« \-1 ¤Î¾ì¹ç¡¢
-¶Ë¥¨¥é¡¼ (pole error) ¤¬È¯À¸¤·¡¢
-´Ø¿ô¤Î¼ïÎà¤Ë±þ¤¸¤Æ¡¢¿ô³ØŪ¤ËÀµ¤·¤¤Éä¹æ¤Î
-.BR HUGE_VAL ,
-.BR HUGE_VALF ,
-.BR HUGE_VALL
-¤¬¤½¤ì¤¾¤ìÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が +1 か \-1 の場合、 極エラー (pole error) が発生し、 関数の種類に応じて、数学的に正しい符号の
+\fBHUGE_VAL\fP, \fBHUGE_VALF\fP, \fBHUGE_VALL\fP がそれぞれ返される。
 
-.I x
-¤ÎÀäÂÐÃͤ¬ 1 ¤è¤êÂ礭¤¤¾ì¹ç¡¢
-Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢
-NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
 .\"
 .\" POSIX.1-2001 documents an optional range error for subnormal x;
 .\" glibc 2.8 does not do this.
-.SH ¥¨¥é¡¼
-¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï
-.BR math_error (7)
-¤ò»²¾È¤Î¤³¤È¡£
+\fIx\fP の絶対値が 1 より大きい場合、 領域エラー (domain error) が発生し、 NaN が返される。
+.SH エラー
+これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7)  を参照のこと。
 .PP
-°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£
-.TP
-Îΰ襨¥é¡¼ (domain error): \fIx\fP ¤¬ \-1 ¤è¤ê¾®¤µ¤¤¤« +1 ¤è¤êÂ礭¤¤
-.I errno
-¤Ë
-.B EDOM
-¤¬ÀßÄꤵ¤ì¤ë¡£
-̵¸ú (invalid) ÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_INVALID )
-¤¬¾å¤¬¤ë¡£
-.TP
-¶Ë¥¨¥é¡¼ (pole error): \fIx\fP ¤¬ +1 ¤« \-1
-.I errno
-¤Ë
-.B ERANGE
-¤¬ÀßÄꤵ¤ì¤ë (⤷¡Ö¥Ð¥°¡×¤ÎÀá¤â»²¾È)¡£
-0 ¤Ë¤è¤ë½ü»» (divide-by-zero) ÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_DIVBYZERO )
-¤¬¾å¤¬¤ë¡£
-.SH ½àµò
-C99, POSIX.1-2001.
-.I double
-ÈǤδؿô¤Ï SVr4, 4.3BSD, C89 ¤Ë¤â½àµò¤·¤Æ¤¤¤ë¡£
-.SH ¥Ð¥°
+以下のエラーが発生する可能性がある。
+.TP 
+領域エラー (domain error): \fIx\fP が \-1 より小さいか +1 より大きい
+\fIerrno\fP に \fBEDOM\fP が設定される。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP)  が上がる。
+.TP 
+極エラー (pole error): \fIx\fP が +1 か \-1
+\fIerrno\fP に \fBERANGE\fP が設定される (「バグ」の節も参照)。 0 による除算 (divide\-by\-zero) 浮動小数点例外
+(\fBFE_DIVBYZERO\fP)  が上がる。
+.SH 準拠
+C99, POSIX.1\-2001.  \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。
+.SH バグ
 .\" Bug: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759
 .\" This can be seen in sysdeps/ieee754/k_standard.c
-glibc 2.9 ¤È¤½¤ì°ÊÁ°¤Î¥Ð¡¼¥¸¥ç¥ó¤Ç¤Ï¡¢
-¶Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¡¢POSIX ¤ÇÍ׵ᤵ¤ì¤Æ¤¤¤ë
-.B ERANGE
-¤Ç¤Ï¤Ê¤¯
-.B EDOM
-¤¬
-.I errno
-¤ËÀßÄꤵ¤ì¤ë¡£
-¥Ð¡¼¥¸¥ç¥ó 2.10 °Ê¹ß¤Î glibc ¤Ç¤Ï¡¢Àµ¤·¤¤Æ°ºî¤ò¤¹¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR acosh (3),
-.BR asinh (3),
-.BR catanh (3),
-.BR cosh (3),
-.BR sinh (3),
-.BR tanh (3)
+glibc 2.9 とそれ以前のバージョンでは、 極エラーが発生した場合、POSIX で要求されている \fBERANGE\fP ではなく \fBEDOM\fP が
+\fIerrno\fP に設定される。 バージョン 2.10 以降の glibc では、正しい動作をする。
+.SH 関連項目
+\fBacosh\fP(3), \fBasinh\fP(3), \fBcatanh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。