OSDN Git Service

(split) LDP: Update release pages based on LDP 3.54 release
[linuxjm/LDP_man-pages.git] / release / man3 / log.3
index 139db03..0a5e6d7 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) 2003  Akihiro MOTOKI
 .\"         all rights reserved.
 .\" Translated Wed Aug  6 00:35:20 JST 2003
 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
-.TH LOG 3  2010-09-20  "" "Linux Programmer's Manual"
-.SH Ì¾Á°
-log, logf, logl \- ¼«Á³Âпô´Ø¿ô
-.SH ½ñ¼°
+.TH LOG 3 2010\-09\-20 "" "Linux Programmer's Manual"
+.SH 名前
+log, logf, logl \- 自然対数関数
+.SH 書式
 .nf
-.B #include <math.h>
+\fB#include <math.h>\fP
 .sp
-.BI "double log(double " x );
+\fBdouble log(double \fP\fIx\fP\fB);\fP
 .br
-.BI "float logf(float " x );
+\fBfloat logf(float \fP\fIx\fP\fB);\fP
 .br
-.BI "long double logl(long double " x );
+\fBlong double logl(long double \fP\fIx\fP\fB);\fP
 .fi
 .sp
-\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 logf (),
-.BR logl ():
+\fBlogf\fP(), \fBlogl\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
-.SH ÀâÌÀ
-.BR log ()
-´Ø¿ô¤Ï \fIx\fP ¤Î¼«Á³Âпô¤òÊÖ¤¹¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï
-.I x
-¤Î¼«Á³Âпô¤òÊÖ¤¹¡£
+.SH 説明
+\fBlog\fP()  関数は \fIx\fP の自然対数を返す。
+.SH 返り値
+成功すると、これらの関数は \fIx\fP の自然対数を返す。
 
-.I x
-¤¬ NaN ¤Î¾ì¹ç¡¢NaN ¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が NaN の場合、NaN が返される。
 
-.I x
-¤¬ 1 ¤Î¾ì¹ç¡¢+0 ¤¬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が 1 の場合、+0 が返される。
 
-.I x
-¤¬Àµ¤Î̵¸ÂÂç¤Î¾ì¹ç¡¢Àµ¤Î̵¸ÂÂ礬ÊÖ¤µ¤ì¤ë¡£
+\fIx\fP が正の無限大の場合、正の無限大が返される。
 
-.I x
-¤¬ 0 ¤Î¾ì¹ç¡¢¶Ë¥¨¥é¡¼ (pole error) ¤¬È¯À¸¤·¡¢
-³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ì
-.RB - HUGE_VAL ,
-.RB - HUGE_VALF ,
-.RB - HUGE_VALL
-¤òÊÖ¤¹¡£
+\fIx\fP が 0 の場合、極エラー (pole error) が発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP,
+\-\fBHUGE_VALL\fP を返す。
 
-.I x
-¤¬Éé¤Î¾ì¹ç (Éé¤Î̵¸ÂÂç¤â´Þ¤à)¡¢Îΰ襨¥é¡¼ (domain error) ¤¬È¯À¸¤·¡¢
-NaN (not a number) ¤¬ÊÖ¤µ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
-¤³¤ì¤é¤Î´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¥¨¥é¡¼¤¬È¯À¸¤·¤¿¤«¤ÎȽÄêÊýË¡¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤Ï
-.BR math_error (7)
-¤ò»²¾È¤Î¤³¤È¡£
+\fIx\fP が負の場合 (負の無限大も含む)、領域エラー (domain error) が発生し、 NaN (not a number) が返される。
+.SH エラー
+これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7)  を参照のこと。
 .PP
-°Ê²¼¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ­¤¬¤¢¤ë¡£
-.TP
-Îΰ襨¥é¡¼ (domain error): \fIx\fP ¤¬Éé¤Ç¤¢¤ë
-.I errno
-¤Ë
-.B EDOM
-¤¬ÀßÄꤵ¤ì¤ë¡£
-ÉÔÀµ (invalid) ÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_INVALID )
-¤¬¾å¤¬¤ë¡£
-.TP
-¶Ë¥¨¥é¡¼ (pole error): \fIx\fP ¤¬ 0 ¤Ç¤¢¤ë
-.I errno
-¤Ë
-.B ERANGE
-¤¬ÀßÄꤵ¤ì¤ë¡£
-0 ¤Ë¤è¤ë½ü»» (divide-by-zero) ÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_DIVBYZERO )
-¤¬¾å¤¬¤ë¡£
-.SH ½àµò
-C99, POSIX.1-2001.
-.I double
-ÈǤδؿô¤Ï SVr4, 4.3BSD, C89 ¤Ë¤â½àµò¤·¤Æ¤¤¤ë¡£
-.SH ¥Ð¥°
-glibc 2.5 °ÊÁ°¤Ç¤Ï¡¢
-NaN ¤ËÂФ·¤Æ
-.BR log ()
-¤ò¤È¤ë¤È¡¢´Ö°ã¤Ã¤ÆÉÔÀµÉâÆ°¾®¿ôÅÀÎã³°
-.RB ( FE_INVALID )
-¤¬È¯À¸¤·¤Æ¤¤¤¿¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR cbrt (3),
-.BR clog (3),
-.BR log2 (3),
-.BR log10 (3),
-.BR log1p (3),
-.BR sqrt (3)
+以下のエラーが発生する可能性がある。
+.TP 
+領域エラー (domain error): \fIx\fP が負である
+\fIerrno\fP に \fBEDOM\fP が設定される。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP)  が上がる。
+.TP 
+極エラー (pole error): \fIx\fP が 0 である
+\fIerrno\fP に \fBERANGE\fP が設定される。 0 による除算 (divide\-by\-zero) 浮動小数点例外
+(\fBFE_DIVBYZERO\fP)  が上がる。
+.SH 準拠
+C99, POSIX.1\-2001.  \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。
+.SH バグ
+glibc 2.5 以前では、 NaN に対して \fBlog\fP()  をとると、間違って不正浮動小数点例外 (\fBFE_INVALID\fP)
+が発生していた。
+.SH 関連項目
+\fBcbrt\fP(3), \fBclog\fP(3), \fBlog10\fP(3), \fBlog1p\fP(3), \fBlog2\fP(3), \fBsqrt\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。