From 4d4cf443334f993c2b40cfd7ae7bf4d32e15b6a6 Mon Sep 17 00:00:00 2001 From: Akihiro Motoki Date: Sat, 27 Mar 2021 17:16:54 +0900 Subject: [PATCH] LDP: Update draft based on the previous commit --- manual/LDP_man-pages/draft/man3/INFINITY.3 | 7 +- manual/LDP_man-pages/draft/man3/abs.3 | 11 +- manual/LDP_man-pages/draft/man3/acos.3 | 5 +- manual/LDP_man-pages/draft/man3/acosh.3 | 6 +- manual/LDP_man-pages/draft/man3/asin.3 | 5 +- manual/LDP_man-pages/draft/man3/asinh.3 | 122 ++++++++++++++++++ manual/LDP_man-pages/draft/man3/atan.3 | 6 +- manual/LDP_man-pages/draft/man3/atan2.3 | 6 +- manual/LDP_man-pages/draft/man3/atanh.3 | 6 +- manual/LDP_man-pages/draft/man3/cbrt.3 | 4 +- manual/LDP_man-pages/draft/man3/ceil.3 | 2 +- manual/LDP_man-pages/draft/man3/copysign.3 | 7 +- manual/LDP_man-pages/draft/man3/cos.3 | 4 +- manual/LDP_man-pages/draft/man3/cosh.3 | 5 +- manual/LDP_man-pages/draft/man3/div.3 | 6 +- manual/LDP_man-pages/draft/man3/erf.3 | 132 +++++++++++++++++++ manual/LDP_man-pages/draft/man3/erfc.3 | 5 +- manual/LDP_man-pages/draft/man3/exp.3 | 5 +- manual/LDP_man-pages/draft/man3/exp10.3 | 2 +- manual/LDP_man-pages/draft/man3/exp2.3 | 4 +- manual/LDP_man-pages/draft/man3/expm1.3 | 148 +++++++++++++++++++++ manual/LDP_man-pages/draft/man3/fabs.3 | 2 +- manual/LDP_man-pages/draft/man3/fenv.3 | 2 +- manual/LDP_man-pages/draft/man3/finite.3 | 138 ++++++++++++++++++++ manual/LDP_man-pages/draft/man3/floor.3 | 2 +- manual/LDP_man-pages/draft/man3/fma.3 | 4 +- manual/LDP_man-pages/draft/man3/fmod.3 | 7 +- manual/LDP_man-pages/draft/man3/frexp.3 | 138 ++++++++++++++++++++ manual/LDP_man-pages/draft/man3/gamma.3 | 3 +- manual/LDP_man-pages/draft/man3/hypot.3 | 10 +- manual/LDP_man-pages/draft/man3/ilogb.3 | 4 +- manual/LDP_man-pages/draft/man3/isgreater.3 | 6 +- manual/LDP_man-pages/draft/man3/j0.3 | 8 +- manual/LDP_man-pages/draft/man3/ldexp.3 | 5 +- manual/LDP_man-pages/draft/man3/lgamma.3 | 15 +-- manual/LDP_man-pages/draft/man3/log.3 | 4 +- manual/LDP_man-pages/draft/man3/log10.3 | 4 +- manual/LDP_man-pages/draft/man3/log1p.3 | 136 ++++++++++++++++++++ manual/LDP_man-pages/draft/man3/log2.3 | 4 +- manual/LDP_man-pages/draft/man3/lround.3 | 120 +++++++++++++++++ manual/LDP_man-pages/draft/man3/matherr.3 | 20 +-- manual/LDP_man-pages/draft/man3/modf.3 | 104 +++++++++++++++ manual/LDP_man-pages/draft/man3/nan.3 | 4 +- manual/LDP_man-pages/draft/man3/nextafter.3 | 6 +- manual/LDP_man-pages/draft/man3/nextup.3 | 94 ++++++++++++++ manual/LDP_man-pages/draft/man3/pow.3 | 11 +- manual/LDP_man-pages/draft/man3/pow10.3 | 80 ++++++++++++ manual/LDP_man-pages/draft/man3/remainder.3 | 171 +++++++++++++++++++++++++ manual/LDP_man-pages/draft/man3/rint.3 | 135 +++++++++++++++++++ manual/LDP_man-pages/draft/man3/scalb.3 | 3 +- manual/LDP_man-pages/draft/man3/scalbln.3 | 4 +- manual/LDP_man-pages/draft/man3/signbit.3 | 4 +- manual/LDP_man-pages/draft/man3/significand.3 | 79 ++++++++++++ manual/LDP_man-pages/draft/man3/sin.3 | 4 +- manual/LDP_man-pages/draft/man3/sincos.3 | 10 +- manual/LDP_man-pages/draft/man3/sinh.3 | 5 +- manual/LDP_man-pages/draft/man3/sqrt.3 | 4 +- manual/LDP_man-pages/draft/man3/tan.3 | 4 +- manual/LDP_man-pages/draft/man3/tanh.3 | 5 +- manual/LDP_man-pages/draft/man3/tgamma.3 | 11 +- manual/LDP_man-pages/draft/man3/trunc.3 | 5 +- manual/LDP_man-pages/draft/man3/y0.3 | 178 ++++++++++++++++++++++++++ manual/LDP_man-pages/draft/man7/math_error.7 | 31 ++--- 63 files changed, 1910 insertions(+), 172 deletions(-) create mode 100644 manual/LDP_man-pages/draft/man3/asinh.3 create mode 100644 manual/LDP_man-pages/draft/man3/erf.3 create mode 100644 manual/LDP_man-pages/draft/man3/expm1.3 create mode 100644 manual/LDP_man-pages/draft/man3/finite.3 create mode 100644 manual/LDP_man-pages/draft/man3/frexp.3 create mode 100644 manual/LDP_man-pages/draft/man3/log1p.3 create mode 100644 manual/LDP_man-pages/draft/man3/lround.3 create mode 100644 manual/LDP_man-pages/draft/man3/modf.3 create mode 100644 manual/LDP_man-pages/draft/man3/nextup.3 create mode 100644 manual/LDP_man-pages/draft/man3/pow10.3 create mode 100644 manual/LDP_man-pages/draft/man3/remainder.3 create mode 100644 manual/LDP_man-pages/draft/man3/rint.3 create mode 100644 manual/LDP_man-pages/draft/man3/significand.3 create mode 100644 manual/LDP_man-pages/draft/man3/y0.3 diff --git a/manual/LDP_man-pages/draft/man3/INFINITY.3 b/manual/LDP_man-pages/draft/man3/INFINITY.3 index 8864d0e2..efda1f87 100644 --- a/manual/LDP_man-pages/draft/man3/INFINITY.3 +++ b/manual/LDP_man-pages/draft/man3/INFINITY.3 @@ -38,7 +38,7 @@ INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL \- 浮動小数点数の定数 .SH 書式 .nf -\fB#define _ISOC99_SOURCE\fP /* See feature_test_macros(7) */ +\fB#define _ISOC99_SOURCE\fP /* feature_test_macros(7) 参照 */ \fB#include \fP .PP \fBINFINITY\fP @@ -56,9 +56,8 @@ INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL \- 浮動小数点数の定数 は計算式の中で使われたときに例外を起こさない NaN ("not\-a\-number") である。 この反対は \fIsignalling\fP NaN である。 IEC 60559:1989 を参照すること。 .PP -The macros \fBHUGE_VAL\fP, \fBHUGE_VALF\fP, \fBHUGE_VALL\fP expand to constants of -types \fIdouble\fP, \fIfloat\fP, and \fIlong double\fP, respectively, that represent -a large positive value, possibly positive infinity. +マクロ \fBHUGE_VAL\fP, \fBHUGE_VALF\fP, \fBHUGE_VALL\fP はそれぞれ \fIdouble\fP, \fIfloat\fP, +\fIlong double\fP 型の定数で、 大きな正の値を表し、可能な場合には正の無限大を表す。 .SH 準拠 C99. .PP diff --git a/manual/LDP_man-pages/draft/man3/abs.3 b/manual/LDP_man-pages/draft/man3/abs.3 index 1fd7642f..08ac3b07 100644 --- a/manual/LDP_man-pages/draft/man3/abs.3 +++ b/manual/LDP_man-pages/draft/man3/abs.3 @@ -70,10 +70,8 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -The \fBabs\fP() function computes the absolute value of the integer argument -\fIj\fP. The \fBlabs\fP(), \fBllabs\fP(), and \fBimaxabs\fP() functions compute the -absolute value of the argument \fIj\fP of the appropriate integer type for the -function. +\fBabs\fP() 関数は、整数の引数 \fIj\fP の絶対値を計算する。 \fBlabs\fP(), \fBllabs\fP(), \fBimaxabs\fP() +関数は、 それぞれの関数の型に応じた引数 \fIj\fP の絶対値を計算する。 .SH 返り値 それぞれの関数の型に応じた整数の引数の絶対値を返す。 .SH 属性 @@ -96,9 +94,8 @@ T} Thread safety MT\-Safe .\" POSIX.1 (1996 edition) requires only the .\" .BR abs () .\" function. -POSIX.1\-2001, POSIX.1\-2008, C99, SVr4, 4.3BSD. C89 only includes the -\fBabs\fP() and \fBlabs\fP() functions; the functions \fBllabs\fP() and -\fBimaxabs\fP() were added in C99. +POSIX.1\-2001, POSIX.1\-2008, C99, SVr4, 4.3BSD. C89 は \fBabs\fP() 関数と +\fBlabs\fP() 関数のみを含んでいる。 \fBllabs\fP() 関数と \fBimaxabs\fP() 関数は C99 で追加された。 .SH 注意 最大の負整数の絶対値は、定義されていない。 .PP diff --git a/manual/LDP_man-pages/draft/man3/acos.3 b/manual/LDP_man-pages/draft/man3/acos.3 index 18726897..e70bb3ef 100644 --- a/manual/LDP_man-pages/draft/man3/acos.3 +++ b/manual/LDP_man-pages/draft/man3/acos.3 @@ -74,8 +74,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions calculate the arc cosine of \fIx\fP; that is the value whose -cosine is \fIx\fP. +これらの関数は \fIx\fP の逆余弦（arc cosine) を計算する。 すなわち、その余弦 (cosine) が \fIx\fP となる値である。 .SH 返り値 成功すると、これらの関数は \fIx\fP の逆余弦をラジアン単位で返す。 返り値は [0,\ pi] の範囲となる。 .PP @@ -109,7 +108,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBasin\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcacos\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) diff --git a/manual/LDP_man-pages/draft/man3/acosh.3 b/manual/LDP_man-pages/draft/man3/acosh.3 index 90a48148..d929e3ae 100644 --- a/manual/LDP_man-pages/draft/man3/acosh.3 +++ b/manual/LDP_man-pages/draft/man3/acosh.3 @@ -83,8 +83,8 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions calculate the inverse hyperbolic cosine of \fIx\fP; that is the -value whose hyperbolic cosine is \fIx\fP. +これらの関数は \fIx\fP の逆双曲線余弦（inverse hyperbolic cosine）を 計算する。 +すなわち、その双曲線余弦（hyperbolic cosine）が \fIx\fP に なるような値である。 .SH 返り値 成功すると、これらの関数は \fIx\fP の逆双曲線余弦を返す。 .PP @@ -118,7 +118,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH 関連項目 \fBasinh\fP(3), \fBatanh\fP(3), \fBcacosh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/asin.3 b/manual/LDP_man-pages/draft/man3/asin.3 index 2ef79d17..3c9e3280 100644 --- a/manual/LDP_man-pages/draft/man3/asin.3 +++ b/manual/LDP_man-pages/draft/man3/asin.3 @@ -74,8 +74,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions calculate the principal value of the arc sine of \fIx\fP; that -is the value whose sine is \fIx\fP. +これらの関数は \fIx\fP の逆正弦（arc sine) の主値を計算する。 すなわち、その正弦（sine）が \fIx\fP となるような値である。 .SH 返り値 成功すると、これらの関数は \fIx\fP の逆正弦の主値をラジアン単位で返す。 返り値は [\-pi/2,\ pi/2] の範囲となる。 .PP @@ -110,7 +109,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBacos\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcasin\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) diff --git a/manual/LDP_man-pages/draft/man3/asinh.3 b/manual/LDP_man-pages/draft/man3/asinh.3 new file mode 100644 index 00000000..69db657b --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/asinh.3 @@ -0,0 +1,122 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" 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 +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) +.\" 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 Kenji Kajiwara and Kentaro Ogawa +.\" Proof Reading: Takashi Yoshino +.\" Updated Tue Aug 5 23:16:48 JST 2003 +.\" by Akihiro MOTOKI +.\" Updated 2008-09-14, Akihiro MOTOKI +.\" +.TH ASINH 3 2017\-09\-15 GNU "Linux Programmer's Manual" +.SH 名前 +asinh, asinhf, asinhl \- 逆双曲線正弦（inverse hyperbolic sine）関数 +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble asinh(double \fP\fIx\fP\fB);\fP +\fBfloat asinhf(float \fP\fIx\fP\fB);\fP +\fBlong double asinhl(long double \fP\fIx\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBasinh\fP(): +.RS 4 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.PP +\fBasinhf\fP(), \fBasinhl\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +これらの関数は \fIx\fP 逆双曲線正弦（inverse hyperbolic sine）を 計算する。すなわち、その双曲線正弦（hyperbolic +sine）が \fIx\fP に なるような値である。 +.SH 返り値 +成功すると、これらの関数は \fIx\fP の逆双曲線正弦を返す。 +.PP +\fIx\fP が NaN の場合、NaN が返される。 +.PP +\fIx\fP が +0 (\-0) の場合、+0 (\-0) が返される。 +.PP +.\" +.\" POSIX.1-2001 documents an optional range error for subnormal x; +.\" glibc 2.8 does not do this. +\fIx\fP が正の無限大 (負の無限大) の場合、正の無限大 (負の無限大) が返される。 +.SH エラー +エラーは発生しない。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw27 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBasinh\fP(), +\fBasinhf\fP(), +\fBasinhl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +C99, POSIX.1\-2001, POSIX.1\-2008. +.PP +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 +.SH 関連項目 +\fBacosh\fP(3), \fBatanh\fP(3), \fBcasinh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/atan.3 b/manual/LDP_man-pages/draft/man3/atan.3 index 48e8aad5..628eb882 100644 --- a/manual/LDP_man-pages/draft/man3/atan.3 +++ b/manual/LDP_man-pages/draft/man3/atan.3 @@ -74,8 +74,8 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions calculate the principal value of the arc tangent of \fIx\fP; -that is the value whose tangent is \fIx\fP. +これらの関数は \fIx\fP の逆正接（arc tangent）の主値を計算する。 すなわち、 その正接（tangent）が \fIx\fP +となるような値である。 .SH 返り値 成功すると、これらの関数は \fIx\fP の逆正接の主値をラジアン単位で返す。 返り値は [\-pi/2,\ pi/2] の範囲となる。 .PP @@ -105,7 +105,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBacos\fP(3), \fBasin\fP(3), \fBatan2\fP(3), \fBcarg\fP(3), \fBcatan\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) diff --git a/manual/LDP_man-pages/draft/man3/atan2.3 b/manual/LDP_man-pages/draft/man3/atan2.3 index b964e1ac..b53f26a6 100644 --- a/manual/LDP_man-pages/draft/man3/atan2.3 +++ b/manual/LDP_man-pages/draft/man3/atan2.3 @@ -74,9 +74,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions calculate the principal value of the arc tangent of \fIy/x\fP, -using the signs of the two arguments to determine the quadrant of the -result. +これらの関数は \fIy/x\fP の逆正接 (arg tangent) の主値を計算する。 二つの引き数の符号は結果の象限を決定するために使われる。 .SH 返り値 成功すると、これらの関数は \fIy/x\fP の逆正接の主値をラジアン単位で返す。 返り値は [\-pi,\ pi] の範囲となる。 .PP @@ -136,7 +134,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBacos\fP(3), \fBasin\fP(3), \fBatan\fP(3), \fBcarg\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) diff --git a/manual/LDP_man-pages/draft/man3/atanh.3 b/manual/LDP_man-pages/draft/man3/atanh.3 index 37cd3162..f2cedcb9 100644 --- a/manual/LDP_man-pages/draft/man3/atanh.3 +++ b/manual/LDP_man-pages/draft/man3/atanh.3 @@ -83,8 +83,8 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions calculate the inverse hyperbolic tangent of \fIx\fP; that is -the value whose hyperbolic tangent is \fIx\fP. +これらの関数は \fIx\fP の逆双曲線正接 (inverse hyperbolic tangent) を計算する。 すなわち、その双曲線正接 +(hyperbolic tangent) が \fIx\fP になるような値である。 .SH 返り値 成功すると、これらの関数は \fIx\fP の逆双曲線正接を返す。 .PP @@ -126,7 +126,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH バグ .\" Bug: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759 .\" This can be seen in sysdeps/ieee754/k_standard.c diff --git a/manual/LDP_man-pages/draft/man3/cbrt.3 b/manual/LDP_man-pages/draft/man3/cbrt.3 index a8862edf..3d27c095 100644 --- a/manual/LDP_man-pages/draft/man3/cbrt.3 +++ b/manual/LDP_man-pages/draft/man3/cbrt.3 @@ -77,8 +77,8 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions return the (real) cube root of \fIx\fP. This function cannot -fail; every representable real value has a representable real cube root. +これらの関数は \fIx\fP の (実数)立方根を返す。 この関数が失敗することはない。なぜなら、 すべての内部表現可能な (representable) +実数は 必ず内部表現可能な立方根を持つためである。 .SH 返り値 これらの関数は \fIx\fP の立方根を返す。 .PP diff --git a/manual/LDP_man-pages/draft/man3/ceil.3 b/manual/LDP_man-pages/draft/man3/ceil.3 index f09425fe..702755f8 100644 --- a/manual/LDP_man-pages/draft/man3/ceil.3 +++ b/manual/LDP_man-pages/draft/man3/ceil.3 @@ -92,7 +92,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 注意 .\" The POSIX.1-2001 APPLICATION USAGE SECTION discusses this point. SUSv2 と POSIX.1\-2001 にはオーバーフローに関する記述があり、 オーバーフローの場合には、 \fIerrno\fP を \fBERANGE\fP diff --git a/manual/LDP_man-pages/draft/man3/copysign.3 b/manual/LDP_man-pages/draft/man3/copysign.3 index b588a337..90b3a133 100644 --- a/manual/LDP_man-pages/draft/man3/copysign.3 +++ b/manual/LDP_man-pages/draft/man3/copysign.3 @@ -68,8 +68,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions return a value whose absolute value matches that of \fIx\fP, -but whose sign bit matches that of \fIy\fP. +これらの関数は絶対値が \fIx\fP に等しく、符号ビットが \fIy\fP に等しい値を返す。 .PP 例えば、 \fIcopysign(42.0,\ \-1.0)\fP と \fIcopysign(\-42.0, \-1.0)\fP はどちらも \-42.0 を返す。 @@ -94,8 +93,8 @@ T} Thread safety MT\-Safe .TE .SH 準拠 .\" 4.3BSD. -C99, POSIX.1\-2001, POSIX.1\-2008. This function is defined in IEC 559 (and -the appendix with recommended functions in IEEE 754/IEEE 854). +C99, POSIX.1\-2001, POSIX.1\-2008. この関数は IEC 559 で定義されている (また IEEE 754/IEEE +854 では付録で推奨関数として定義されている)。 .SH 注意 浮動小数点形式が IEEE 754 準拠でないアーキテクチャーでは、 これらの関数は負の 0 を正として扱うことがある。 .SH 関連項目 diff --git a/manual/LDP_man-pages/draft/man3/cos.3 b/manual/LDP_man-pages/draft/man3/cos.3 index de5b6375..49df5f7d 100644 --- a/manual/LDP_man-pages/draft/man3/cos.3 +++ b/manual/LDP_man-pages/draft/man3/cos.3 @@ -75,7 +75,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the cosine of \fIx\fP, where \fIx\fP is given in radians. +これらの関数は \fIx\fP の余弦 (コサイン) の値を返す。 \fIx\fP はラジアン単位で指定する。 .SH 返り値 成功すると、これらの関数は \fIx\fP の余弦を返す。 .PP @@ -106,7 +106,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH バグ .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780 バージョン 2.10 より前の glibc の実装では、 領域エラーが発生した際に、 \fIerrno\fP に \fBEDOM\fP が設定されなかった。 diff --git a/manual/LDP_man-pages/draft/man3/cosh.3 b/manual/LDP_man-pages/draft/man3/cosh.3 index 8a011eae..62c8f855 100644 --- a/manual/LDP_man-pages/draft/man3/cosh.3 +++ b/manual/LDP_man-pages/draft/man3/cosh.3 @@ -76,8 +76,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the hyperbolic cosine of \fIx\fP, which is defined -mathematically as: +これらの関数は双曲線余弦 (ハイパボリックコサイン) の値を返す。 数学的には以下のように定義される. .PP .nf cosh(x) = (exp(x) + exp(\-x)) / 2 @@ -116,7 +115,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH バグ glibc バージョン 2.3.4 以前では、オーバーフローが発生したときに、 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がらなかった。 diff --git a/manual/LDP_man-pages/draft/man3/div.3 b/manual/LDP_man-pages/draft/man3/div.3 index 678ad497..629df570 100644 --- a/manual/LDP_man-pages/draft/man3/div.3 +++ b/manual/LDP_man-pages/draft/man3/div.3 @@ -97,9 +97,9 @@ T{ T} Thread safety MT\-Safe .TE .SH 準拠 -POSIX.1\-2001, POSIX.1\-2008, C89, C99, SVr4, 4.3BSD. The functions -\fBlldiv\fP() and \fBimaxdiv\fP() were added in C99. -.SH EXAMPLES +POSIX.1\-2001, POSIX.1\-2008, C89, C99, SVr4, 4.3BSD. 関数 \fBlldiv\fP() と +\fBimaxdiv\fP() は C99 に追加された。 +.SH 例 以下の式を計算すると、 .PP .in +4n diff --git a/manual/LDP_man-pages/draft/man3/erf.3 b/manual/LDP_man-pages/draft/man3/erf.3 new file mode 100644 index 00000000..80b6ae17 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/erf.3 @@ -0,0 +1,132 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" 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 +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) +.\" 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) 1997 YOSHINO Takashi +.\" all rights reserved. +.\" Translated Mon Jan 20 20:17:40 JST 1997 +.\" by YOSHINO Takashi +.\" Updated Tue Aug 5 23:16:48 JST 2003 +.\" by Akihiro MOTOKI +.\" Updated & Modified Tue Feb 15 04:46:24 JST 2005 +.\" by Yuichi SATO +.\" +.TH ERF 3 2017\-09\-15 GNU "Linux Programmer's Manual" +.SH 名前 +erf, erff, erfl \- 誤差関数 +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble erf(double \fP\fIx\fP\fB);\fP +\fBfloat erff(float \fP\fIx\fP\fB);\fP +\fBlong double erfl(long double \fP\fIx\fP\fB);\fP +.PP +.fi +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBerf\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.br +\fBerff\fP(), \fBerfl\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +これらの関数は \fIx\fP の誤差関数を返す関数で、以下のように定義されている。 +.TP + erf(x) = 2/sqrt(pi) * integral from 0 to x of exp(\-t*t) dt +.SH 返り値 +成功すると、これらの関数は \fIx\fP の誤差関数の値を返す。 返り値は [\-1,\ 1] の範囲となる。 +.PP +\fIx\fP が NaN の場合、NaN が返される。 +.PP +\fIx\fP が +0 (\-0) の場合、+0 (\-0) が返される。 +.PP +\fIx\fP が正の無限大 (負の無限大) の場合、+1 (\-1) が返される。 +.PP +\fIx\fP が非正規化数の場合、範囲エラー (range error) が発生し、 返り値は 2*x/sqrt(pi) となる。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 +.PP +以下のエラーが発生する可能性がある。 +.TP +範囲エラー (range error): 結果がアンダーフローする (\fIx\fP が非正規化数) +.\" .I errno +.\" is set to +.\" .BR ERANGE . +アンダーフロー浮動小数点例外 (\fBFE_UNDERFLOW\fP) が上がる。 +.PP +.\" It is intentional that these functions do not set errno for this case +.\" see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785 +これらの関数は \fIerrno\fP を設定しない。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw21 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBerf\fP(), +\fBerff\fP(), +\fBerfl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +C99, POSIX.1\-2001, POSIX.1\-2008. +.PP +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 +.SH 関連項目 +\fBcerf\fP(3), \fBerfc\fP(3), \fBexp\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/erfc.3 b/manual/LDP_man-pages/draft/man3/erfc.3 index a7eeeefd..662a071f 100644 --- a/manual/LDP_man-pages/draft/man3/erfc.3 +++ b/manual/LDP_man-pages/draft/man3/erfc.3 @@ -67,8 +67,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions return the complementary error function of \fIx\fP, that is, -1.0 \- erf(x). +これらの関数は \fIx\fP の相補誤差関数、つまり 1.0 \- erf(x) を返す。 .SH 返り値 成功すると、これらの関数は \fIx\fP の相補誤差関数を返す。 返り値は [0,2] の範囲となる。 .PP @@ -115,7 +114,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH 注意 関数 \fBerfc\fP(), \fBerfcf\fP(), \fBerfcl\fP() が提供されているのは、 \fIx\fP が大きな値の場合に (erf(x) の値は 1 に近付いていくことで) 1\-erf(x) の計算において精度が失われるのを避けるためである。 diff --git a/manual/LDP_man-pages/draft/man3/exp.3 b/manual/LDP_man-pages/draft/man3/exp.3 index bc1f38f0..d3c38469 100644 --- a/manual/LDP_man-pages/draft/man3/exp.3 +++ b/manual/LDP_man-pages/draft/man3/exp.3 @@ -72,8 +72,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions return the value of e (the base of natural logarithms) -raised to the power of \fIx\fP. +これらの関数は e の \fIx\fP 乗の値を返す (e は自然対数の底)。 .SH 返り値 成功すると、これらの関数は e の \fIx\fP 乗を返す。 .PP @@ -113,7 +112,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBcbrt\fP(3), \fBcexp\fP(3), \fBexp10\fP(3), \fBexp2\fP(3), \fBexpm1\fP(3), \fBsqrt\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/exp10.3 b/manual/LDP_man-pages/draft/man3/exp10.3 index 56a57ef8..a22dbc93 100644 --- a/manual/LDP_man-pages/draft/man3/exp10.3 +++ b/manual/LDP_man-pages/draft/man3/exp10.3 @@ -58,7 +58,7 @@ exp10, exp10f, exp10l \- 基数が 10 の指数関数 .PP \fI\-lm\fP でリンクする。 .SH 説明 -These functions return the value of 10 raised to the power of \fIx\fP. +これらの関数は 10 の \fIx\fP 乗の値を返す。 .SH 返り値 成功すると、これらの関数は 10 の \fIx\fP 乗を返す。 .PP diff --git a/manual/LDP_man-pages/draft/man3/exp2.3 b/manual/LDP_man-pages/draft/man3/exp2.3 index f8a4886f..acc75099 100644 --- a/manual/LDP_man-pages/draft/man3/exp2.3 +++ b/manual/LDP_man-pages/draft/man3/exp2.3 @@ -69,7 +69,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions return the value of 2 raised to the power of \fIx\fP. +これらの関数は 2 の \fIx\fP 乗の値を返す。 .SH 返り値 成功すると、これらの関数は 2 の \fIx\fP 乗を返す。 .PP @@ -96,7 +96,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH 関連項目 \fBcbrt\fP(3), \fBcexp2\fP(3), \fBexp\fP(3), \fBexp10\fP(3), \fBsqrt\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/expm1.3 b/manual/LDP_man-pages/draft/man3/expm1.3 new file mode 100644 index 00000000..6327ddea --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/expm1.3 @@ -0,0 +1,148 @@ +.\" Copyright 1995 Jim Van Zandt +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" Modified 2002-07-27 Walter Harms +.\" (walter.harms@informatik.uni-oldenburg.de) +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved. +.\" Translated Mon May 18 1998 by NAKANO Takeo +.\" Update Tue Sep 23 2003 by Akihiro MOTOKI +.\" Updated 2008-09-16, Akihiro MOTOKI +.\" +.TH EXPM1 3 2020\-06\-09 "" "Linux Programmer's Manual" +.SH 名前 +expm1, expm1f, expm1l \- 引き数の指数から 1 を引いた値 +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble expm1(double \fP\fIx\fP\fB);\fP +\fBfloat expm1f(float \fP\fIx\fP\fB);\fP +\fBlong double expm1l(long double \fP\fIx\fP\fB);\fP +.PP +.fi +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBexpm1\fP(): +.RS 4 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.br +\fBexpm1f\fP(), \fBexpm1l\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +これらの関数は、以下と等価な値を返す。 +.PP +.nf + exp(x) \- 1 +.fi +.PP +結果の計算は、 \fIx\fP が 0 の近傍で、非常に近い 2 つの数字の引き算のため \fIexp(x) \- 1\fP +が不正確になるような場合でも正確となる方法で行われる。 +.SH 返り値 +成功すると、これらの関数は \fIexp(x)\ \-\ 1\fP を返す。 +.PP +\fIx\fP が NaN の場合、NaN が返される。 +.PP +\fIx\fP が +0 (\-0) の場合、+0 (\-0) が返される。 +.PP +\fIx\fP が正の無限大の場合、正の無限大が返される。 +.PP +\fIx\fP が負の無限大の場合、\-1 が返される。 +.PP +結果がオーバーフローする場合、範囲エラー (range error) が発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, +\-\fBHUGE_VALF\fP, \-\fBHUGE_VALL\fP を返す。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 +.PP +以下のエラーが発生する可能性がある。 +.TP +範囲エラー (range error)、オーバーフローの場合 +.\" +.\" POSIX.1 specifies an optional range error (underflow) if +.\" x is subnormal. Glibc does not implement this. +\fIerrno\fP に \fBERANGE\fP が設定される (「バグ」の節も参照)。 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) +が上がる。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw27 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBexpm1\fP(), +\fBexpm1f\fP(), +\fBexpm1l\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +.\" BSD. +C99, POSIX.1\-2001, POSIX.1\-2008. +.SH バグ +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778 +Before glibc 2.17, on certain architectures (e.g., x86, but not x86_64) +\fBexpm1\fP() raised a bogus underflow floating\-point exception for some large +negative \fIx\fP values (where the function result approaches \-1), +.PP +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814 +.\" e.g., expm1(1e5) through expm1(1.00199970127e5), +.\" but not expm1(1.00199970128e5) and beyond. +glibc 2.11 あたりより前では、 \fBexpm1\fP() は、 \fIx\fP +が正の大きな値の場合、期待通りのオーバーフロー例外だけでなく間違って不正な (invalid) 浮動小数点例外を上げ、正の無限大ではなく NaN +を返していた。 +.PP +.\" It looks like the fix was in 2.11, or possibly 2.12. +.\" I have no test system for 2.11, but 2.12 passes. +.\" From the source (sysdeps/i386/fpu/s_expm1.S) it looks +.\" like the changes were in 2.11. +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788 +バージョン 2.11 より前の glibc の実装では、 範囲エラーが発生した場合に、 \fIerrno\fP に \fBERANGE\fP が設定されなかった。 +.SH 関連項目 +\fBexp\fP(3), \fBlog\fP(3), \fBlog1p\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/fabs.3 b/manual/LDP_man-pages/draft/man3/fabs.3 index 339ef13f..e756df11 100644 --- a/manual/LDP_man-pages/draft/man3/fabs.3 +++ b/manual/LDP_man-pages/draft/man3/fabs.3 @@ -99,7 +99,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBabs\fP(3), \fBcabs\fP(3), \fBceil\fP(3), \fBfloor\fP(3), \fBlabs\fP(3), \fBrint\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/fenv.3 b/manual/LDP_man-pages/draft/man3/fenv.3 index 1372ef72..c6b0ee42 100644 --- a/manual/LDP_man-pages/draft/man3/fenv.3 +++ b/manual/LDP_man-pages/draft/man3/fenv.3 @@ -199,7 +199,7 @@ IEC 60559 (IEC 559:1989), ANSI/IEEE 854, C99, POSIX.1\-2001. \fBfegetexcept\fP() によって状態の問い合わせもできるようになっている。 .PP .nf -\fB#define _GNU_SOURCE\fP /* See feature_test_macros(7) */ +\fB#define _GNU_SOURCE\fP /* feature_test_macros(7) 参照 */ \fB#include \fP .PP \fBint feenableexcept(int \fP\fIexcepts\fP\fB);\fP diff --git a/manual/LDP_man-pages/draft/man3/finite.3 b/manual/LDP_man-pages/draft/man3/finite.3 new file mode 100644 index 00000000..f42f728b --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/finite.3 @@ -0,0 +1,138 @@ +.\" Copyright 2004 Andries Brouwer . +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 2005 Akihiro MOTOKI +.\" all rights reserved. +.\" Translated 2005-02-21, Akihiro MOTOKI +.\" Updated 2008-09-16, Akihiro MOTOKI +.\" Updated 2013-08-16, Akihiro MOTOKI +.\" +.TH FINITE 3 2017\-09\-15 "" "Linux Programmer's Manual" +.SH 名前 +finite, finitef, finitel, isinf, isinff, isinfl, isnan, isnanf, isnanl \- BSD +の浮動小数点分類関数 +.SH 書式 +.nf +\fB#include \fP +.PP +\fBint finite(double \fP\fIx\fP\fB);\fP +\fBint finitef(float \fP\fIx\fP\fB);\fP +\fBint finitel(long double \fP\fIx\fP\fB);\fP +.PP +\fBint isinf(double \fP\fIx\fP\fB);\fP +\fBint isinff(float \fP\fIx\fP\fB);\fP +\fBint isinfl(long double \fP\fIx\fP\fB);\fP +.PP +\fBint isnan(double \fP\fIx\fP\fB);\fP +\fBint isnanf(float \fP\fIx\fP\fB);\fP +\fBint isnanl(long double \fP\fIx\fP\fB);\fP +.fi +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBfinite\fP(), \fBfinitef\fP(), \fBfinitel\fP(): +.RS 4 +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +\fBisinf\fP(): +.RS 4 +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.br +\fBisinff\fP(), \fBisinfl\fP(): +.RS 4 +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +\fBisnan\fP(): +.RS 4 +_XOPEN_SOURCE || _ISOC99_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +\fBisnanf\fP(), \fBisnanl\fP(): +.RS 4 +_XOPEN_SOURCE\ >=\ 600 + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +関数 \fBfinite\fP(), \fBfinitef\fP(), \fBfinitel\fP() は、 \fIx\fP が無限大や無効値 (NaN) +のいずれでもない場合に 0 以外の値を返し、 それ以外の場合は 0 を返す。 +.PP +関数 \fBisnan\fP(), \fBisnanf\fP(), and \fBisnanl\fP() 関数は、 \fIx\fP が NaN の場合 0 以外の値を返し、 +それ以外の場合は 0 を返す。 +.PP +関数 \fBisinf\fP(), \fBisinff\fP(), \fBisinfl\fP() は、 \fIx\fP が正の無限大であれば 1 を返し、\fIx\fP +が負の無限大で あれば \-1 を返す。それ以外の場合は 0 を返す。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw31 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBfinite\fP(), +\fBfinitef\fP(), +\fBfinitel\fP(), +.br +\fBisinf\fP(), +\fBisinff\fP(), +\fBisinfl\fP(), +.br +\fBisnan\fP(), +\fBisnanf\fP(), +\fBisnanl\fP() +T} Thread safety MT\-Safe +.TE +.SH 注意 +.\" +.\" finite* not on HP-UX; they exist on Tru64. +.\" .SH HISTORY +.\" The +.\" .BR finite () +.\" function occurs in 4.3BSD. +.\" see IEEE.3 in the 4.3BSD manual +これらの関数は廃止された点に注意すること。 C99 では、これらの置き換えとして (どんな型にも適用できる) \fBisfinite\fP(), +\fBisinf\fP(), \fBisnan\fP() というマクロが定義されている。 さらに C99 の \fBisinf\fP() +は返り値に関して弱い意味での保証しかないことにも 注意すること。詳細は \fBfpclassify\fP(3) を参照。 +.SH 関連項目 +\fBfpclassify\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/floor.3 b/manual/LDP_man-pages/draft/man3/floor.3 index 774ba47f..f97d826f 100644 --- a/manual/LDP_man-pages/draft/man3/floor.3 +++ b/manual/LDP_man-pages/draft/man3/floor.3 @@ -92,7 +92,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 注意 .\" The POSIX.1-2001 APPLICATION USAGE SECTION discusses this point. SUSv2 と POSIX.1\-2001 にはオーバーフローに関する記述があり、 オーバーフローの場合には、 \fIerrno\fP を \fBERANGE\fP diff --git a/manual/LDP_man-pages/draft/man3/fma.3 b/manual/LDP_man-pages/draft/man3/fma.3 index c0c4eb76..caa92e08 100644 --- a/manual/LDP_man-pages/draft/man3/fma.3 +++ b/manual/LDP_man-pages/draft/man3/fma.3 @@ -47,8 +47,8 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions compute \fIx\fP * \fIy\fP + \fIz\fP. The result is rounded as one -ternary operation according to the current rounding mode (see \fBfenv\fP(3)). +これらの関数は \fIx\fP * \fIy\fP + \fIz\fP を計算する。 結果は、一つの三項演算として現在の丸めモードにしたがって丸められる +(\fBfenv\fP(3) 参照)。 .SH 返り値 これらの関数は \fIx\fP * \fIy\fP + \fIz\fP の、一つの三項演算として丸められた値を返す。 .PP diff --git a/manual/LDP_man-pages/draft/man3/fmod.3 b/manual/LDP_man-pages/draft/man3/fmod.3 index 6e950eed..a814a077 100644 --- a/manual/LDP_man-pages/draft/man3/fmod.3 +++ b/manual/LDP_man-pages/draft/man3/fmod.3 @@ -72,9 +72,8 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions compute the floating\-point remainder of dividing \fIx\fP by -\fIy\fP. The return value is \fIx\fP \- \fIn\fP * \fIy\fP, where \fIn\fP is the quotient of -\fIx\fP / \fIy\fP, rounded toward zero to an integer. +これらの関数は \fIx\fP を \fIy\fP で割った浮動小数点剰余を計算する。 返り値は \fIx\fP \- \fIn\fP * \fIy\fP である。 ここで、\fIn\fP +は \fIx\fP / \fIy\fP の商を ゼロに向かう方向で整数値に丸めたものである。 .SH 返り値 成功すると、これらの関数は \fIx\fP\ \-\ \fIn\fP*\fIy\fP を返す。 \fIn\fP は、返り値が \fIx\fP と同じ符号で、その絶対値が \fIy\fP の絶対値よりも小さくなるような整数である。 @@ -115,7 +114,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH バグ .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784 バージョン 2.10 より前の glibc の実装では、 無限大で領域エラーが発生した際に、 \fIerrno\fP に \fBEDOM\fP が設定されなかった。 diff --git a/manual/LDP_man-pages/draft/man3/frexp.3 b/manual/LDP_man-pages/draft/man3/frexp.3 new file mode 100644 index 00000000..123fbb5b --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/frexp.3 @@ -0,0 +1,138 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" 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 +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) +.\" 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) 1997 YOSHINO Takashi +.\" all rights reserved. +.\" Translated 1997-01-21, YOSHINO Takashi +.\" Updated 2003-10-15, Kentaro Shirakata +.\" Updated 2005-11-19, Akihiro MOTOKI +.\" +.TH FREXP 3 2020\-06\-09 "" "Linux Programmer's Manual" +.SH 名前 +frexp, frexpf, frexpl \- 浮動小数点実数を小数成分と整数成分に変換する +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble frexp(double \fP\fIx\fP\fB, int *\fP\fIexp\fP\fB);\fP +\fBfloat frexpf(float \fP\fIx\fP\fB, int *\fP\fIexp\fP\fB);\fP +\fBlong double frexpl(long double \fP\fIx\fP\fB, int *\fP\fIexp\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBfrexpf\fP(), \fBfrexpl\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad +.SH 説明 +これらの関数は浮動小数点実数 \fIx\fP を正規化小数と指数に分解し、 指数を *\fIexp\fP に格納する。 +.SH 返り値 +これらの関数は正規化小数を返す。 引数 \fIx\fP がゼロでない場合、この正規化小数は \fIx\fP に 2 の累乗を乗じたものであり、その絶対値は 常に +1/2 以上 1 未満、つまり [0.5,1) となる。 +.PP +\fIx\fP がゼロの場合、正規化小数はゼロになり *\fIexp\fP にはゼロが格納される。 +.PP +\fIx\fP が NaN の場合、NaN が返される。 \fI*exp\fP の値は不定である。 +.PP +\fIx\fP が正の無限大 (負の無限大) の場合、 正の無限大 (負の無限大) が返される。 \fI*exp\fP の値は不定である。 +.SH エラー +エラーは発生しない。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw27 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBfrexp\fP(), +\fBfrexpf\fP(), +\fBfrexpl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +C99, POSIX.1\-2001, POSIX.1\-2008. +.PP +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 +.SH 例 +このプログラムを実行すると以下のような結果となる: +.PP +.in +4n +.EX +$\fB ./a.out 2560\fP +frexp(2560, &e) = 0.625: 0.625 * 2\(ha12 = 2560 +$\fB ./a.out \-4\fP +frexp(\-4, &e) = \-0.5: \-0.5 * 2\(ha3 = \-4 +.EE +.in +.SS プログラムのソース +\& +.EX +#include +#include +#include +#include + +int +main(int argc, char *argv[]) +{ + double x, r; + int exp; + + x = strtod(argv[1], NULL); + r = frexp(x, &exp); + + printf("frexp(%g, &e) = %g: %g * %d\(ha%d = %g\en", + x, r, r, FLT_RADIX, exp, x); + exit(EXIT_SUCCESS); +} +.EE +.SH 関連項目 +\fBldexp\fP(3), \fBmodf\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/gamma.3 b/manual/LDP_man-pages/draft/man3/gamma.3 index 6be2dd2f..50878028 100644 --- a/manual/LDP_man-pages/draft/man3/gamma.3 +++ b/manual/LDP_man-pages/draft/man3/gamma.3 @@ -81,8 +81,7 @@ T{ T} Thread safety MT\-Unsafe race:signgam .TE .SH 準拠 -Because of historical variations in behavior across systems, this function -is not specified in any recent standard. It was documented in SVID 2. +システムによって振舞いが異なるという歴史的な経緯のため、この関数は最近のどの標準規格でも規定されていない。 SVID 2 には記載されていた。 .SH 注意 .SS 歴史 4.2BSDにおいては、関数 \fBgamma\fP() が実際に計算するのは ln(|Gamma(|\fIx\fP|)|) であり、 diff --git a/manual/LDP_man-pages/draft/man3/hypot.3 b/manual/LDP_man-pages/draft/man3/hypot.3 index e9bd67c7..7fbd8f05 100644 --- a/manual/LDP_man-pages/draft/man3/hypot.3 +++ b/manual/LDP_man-pages/draft/man3/hypot.3 @@ -81,16 +81,14 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions return sqrt(\fIx\fP*\fIx\fP+\fIy\fP*\fIy\fP). This is the length of the -hypotenuse of a right\-angled triangle with sides of length \fIx\fP and \fIy\fP, or -the distance of the point (\fIx\fP,\fIy\fP) from the origin. +これらの関数は sqrt(\fIx\fP*\fIx\fP+\fIy\fP*\fIy\fP) の値を返す。 これは 直角を挟む 2 辺の長さが \fIx\fP と \fIy\fP +である直角三角形の斜辺の長さ、 すなわち、原点と点 (\fIx\fP,\fIy\fP) との距離である。 .PP .\" e.g., hypot(DBL_MIN, DBL_MIN) does the right thing, as does, say .\" hypot(DBL_MAX/2.0, DBL_MAX/2.0). 計算の中間ステップでは、必要以上のオーバーフローやアンダーフローが 起きないようにして計算が実行される。 .SH 返り値 -On success, these functions return the length of the hypotenuse of a -right\-angled triangle with sides of length \fIx\fP and \fIy\fP. +成功すると、これらの関数は、 直角を挟む 2 辺の長さが \fIx\fP と \fIy\fP である直角三角形の斜辺の長さを返す。 .PP \fIx\fP か \fIy\fP が無限大の場合、正の無限大が返される。 .PP @@ -133,7 +131,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH 関連項目 \fBcabs\fP(3), \fBsqrt\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/ilogb.3 b/manual/LDP_man-pages/draft/man3/ilogb.3 index ae9cb366..cdd2dfa5 100644 --- a/manual/LDP_man-pages/draft/man3/ilogb.3 +++ b/manual/LDP_man-pages/draft/man3/ilogb.3 @@ -127,8 +127,8 @@ C99, POSIX.1\-2001, POSIX.1\-2008. .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794 バージョン 2.16 より前では、これらの関数の glibc 実装には以下のバグが存在した。 .IP * 3 -The domain error case where \fIx\fP is 0 or a NaN did not cause \fIerrno\fP to be -set or (on some architectures) raise a floating\-point exception. +\fIx\fP が 0 か NaN の場合の領域エラーで、\fIerrno\fP が設定されなかったり、(アーキテクチャーによっては) +浮動小数点例外が上がらなかった。 .IP * 3 \fIx\fP が無限大の場合の領域エラーで、\fIerrno\fP が設定されず、浮動小数点例外が上がらなかった。 .SH 関連項目 diff --git a/manual/LDP_man-pages/draft/man3/isgreater.3 b/manual/LDP_man-pages/draft/man3/isgreater.3 index b787beda..e372788f 100644 --- a/manual/LDP_man-pages/draft/man3/isgreater.3 +++ b/manual/LDP_man-pages/draft/man3/isgreater.3 @@ -55,9 +55,9 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -The normal relational operations (like \fB<\fP, "less than") fail if one -of the operands is NaN. This will cause an exception. To avoid this, C99 -defines the macros listed below. +(\fB<\fP、「小なり」のような) 通常の関係操作 (relational operations) は、 +オペランドの一方が NaN の場合には失敗する。 これは例外の原因になる。 +これを避けるため、C99 では以下のリストに示すマクロを定義している。 .PP これらのマクロでは、引き数を 1 回だけ評価することが保証されている。 引き数には実数の浮動小数点数型を指定しなければならない。 diff --git a/manual/LDP_man-pages/draft/man3/j0.3 b/manual/LDP_man-pages/draft/man3/j0.3 index 23602025..9c91bef8 100644 --- a/manual/LDP_man-pages/draft/man3/j0.3 +++ b/manual/LDP_man-pages/draft/man3/j0.3 @@ -134,12 +134,10 @@ T{ T} Thread safety MT\-Safe .TE .SH 準拠 -The functions returning \fIdouble\fP conform to SVr4, 4.3BSD, POSIX.1\-2001, and -POSIX.1\-2008. The others are nonstandard functions that also exist on the -BSDs. +\fIdouble\fP 型の値を返す関数は、SVr4, 4.3BSD, POSIX.1\-2001, POSIX.1\-2008 に準拠する。 +それ以外は非標準の関数で、BSD にも存在する。 .SH バグ -There are errors of up to 2e\-16 in the values returned by \fBj0\fP(), \fBj1\fP(), -and \fBjn\fP() for values of \fIx\fP between \-8 and 8. +\-8 から 8 までの \fIx\fP の値について \fBj0\fP(), \fBj1\fP(), \fBjn\fP() が返す値には、最大で 2e\-16 の誤差がある。 .SH 関連項目 \fBy0\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/ldexp.3 b/manual/LDP_man-pages/draft/man3/ldexp.3 index dad2d7e3..0989516b 100644 --- a/manual/LDP_man-pages/draft/man3/ldexp.3 +++ b/manual/LDP_man-pages/draft/man3/ldexp.3 @@ -73,8 +73,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the result of multiplying the floating\-point number -\fIx\fP by 2 raised to the power \fIexp\fP. +これらの関数は、浮動小数点実数 \fIx\fP と 2 の \fIexp\fP 乗との積を返す。 .SH 返り値 成功すると、これらの関数は \fIx * (2^exp)\fP を返す。 .PP @@ -114,7 +113,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBfrexp\fP(3), \fBmodf\fP(3), \fBscalbln\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/lgamma.3 b/manual/LDP_man-pages/draft/man3/lgamma.3 index 3c9ef84c..84a6a497 100644 --- a/manual/LDP_man-pages/draft/man3/lgamma.3 +++ b/manual/LDP_man-pages/draft/man3/lgamma.3 @@ -76,11 +76,9 @@ _XOPEN_SOURCE .SH 説明 ガンマ関数の定義については、 \fBtgamma\fP(3) を参照のこと。 .PP -The \fBlgamma\fP(), \fBlgammaf\fP(), and \fBlgammal\fP() functions return the -natural logarithm of the absolute value of the Gamma function. The sign of -the Gamma function is returned in the external integer \fIsigngam\fP declared -in \fI\fP. It is 1 when the Gamma function is positive or -zero, \-1 when it is negative. +関数 \fBlgamma\fP(), \fBlgammaf\fP(), \fBlgammal\fP() は、ガンマ関数の絶対値の自然対数を返す。 ガンマ関数の符号は、 +\fI\fP で宣言されている extern int \fIsigngam\fP に格納される。 +格納される値は、ガンマ関数が正または 0 の場合 1、 負の場合 \-1 である。 .PP \fIsigngam\fP という固定された場所を使うことはスレッドセーフではないので、 関数 \fBlgamma_r\fP(), \fBlgammaf_r\fP(), \fBlgammal_r\fP() が導入された。 これらの関数では、符号は引き数 \fIsignp\fP 経由で返される。 @@ -113,10 +111,9 @@ zero, \-1 when it is negative. .\" exception for various cases. \fIerrno\fP に \fBERANGE\fP が設定される。 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。 .SH 準拠 -The \fBlgamma\fP() functions are specified in C99, POSIX.1\-2001, and -POSIX.1\-2008. \fIsigngam\fP is specified in POSIX.1\-2001 and POSIX.1\-2008, but -not in C99. The \fBlgamma_r\fP() functions are nonstandard, but present on -several other systems. +関数 \fBlgamma\fP() は C99, POSIX.1\-2001, POSIX.1\-2008 で規定されている。 \fIsigngam\fP は +POSIX.1\-2001 と POSIX.1\-2008 で規定されているが、C99 にはない。 関数 \fBlgamma_r\fP() +は非標準だが、いくつかの他のシステムにも存在する。 .SH バグ .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777 glibc 2.9 とそれ以前のバージョンでは、 極エラーが発生した場合、POSIX で要求されている \fBERANGE\fP ではなく \fBEDOM\fP が diff --git a/manual/LDP_man-pages/draft/man3/log.3 b/manual/LDP_man-pages/draft/man3/log.3 index 9086c22c..a2af8113 100644 --- a/manual/LDP_man-pages/draft/man3/log.3 +++ b/manual/LDP_man-pages/draft/man3/log.3 @@ -72,7 +72,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the natural logarithm of \fIx\fP. +これらの関数は \fIx\fP の自然対数を返す。 .SH 返り値 成功すると、これらの関数は \fIx\fP の自然対数を返す。 .PP @@ -113,7 +113,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH バグ glibc 2.5 以前では、 NaN に対して \fBlog\fP() をとると、間違って不正浮動小数点例外 (\fBFE_INVALID\fP) が発生していた。 diff --git a/manual/LDP_man-pages/draft/man3/log10.3 b/manual/LDP_man-pages/draft/man3/log10.3 index 09f50a30..87498675 100644 --- a/manual/LDP_man-pages/draft/man3/log10.3 +++ b/manual/LDP_man-pages/draft/man3/log10.3 @@ -72,7 +72,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the base 10 logarithm of \fIx\fP. +これらの関数は \fIx\fP の常用対数 (底が 10 の対数) を返す。 .SH 返り値 成功すると、これらの関数は \fIx\fP の常用対数 (底が 10 の対数) を返す。 .PP @@ -97,7 +97,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBcbrt\fP(3), \fBclog10\fP(3), \fBexp10\fP(3), \fBlog\fP(3), \fBlog2\fP(3), \fBsqrt\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/log1p.3 b/manual/LDP_man-pages/draft/man3/log1p.3 new file mode 100644 index 00000000..f68b521d --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/log1p.3 @@ -0,0 +1,136 @@ +.\" Copyright 1995 Jim Van Zandt +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" 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 +.\" Updated 2008-09-16, Akihiro MOTOKI +.\" +.TH LOG1P 3 2017\-09\-15 "" "Linux Programmer's Manual" +.SH 名前 +log1p, log1pf, log1pl \- 引き数に 1 を加えた値の対数 +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble log1p(double \fP\fIx\fP\fB);\fP +\fBfloat log1pf(float \fP\fIx\fP\fB);\fP +\fBlong double log1pl(long double \fP\fIx\fP\fB);\fP +.PP +.fi +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBlog1p\fP(): +.RS 4 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.br +\fBlog1pf\fP(), \fBlog1pl\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +これらの関数は、以下と等価な値を返す。 +.PP +.nf + log (1 + \fIx\fP) +.fi +.PP +結果は、 \fIx\fP の値が 0 に近い場合でも正確となる方法で計算される。 +.SH 返り値 +成功すると、これらの関数は \fI(1\ +\ x)\fP の自然対数を返す。 +.PP +\fIx\fP が NaN の場合、NaN が返される。 +.PP +\fIx\fP が正の無限大の場合、正の無限大が返される。 +.PP +\fIx\fP が \-1 の場合、極エラー (pole error) が発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP, +\-\fBHUGE_VALL\fP を返す。 +.PP +.\" POSIX.1 specifies a possible range error if x is subnormal +.\" glibc 2.8 doesn't do this +\fIx\fP が \-1 より小さい場合 (負の無限大も含む)、 領域エラー (domain error) が発生し、 NaN (not a number) +が返される。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 +.PP +以下のエラーが発生する可能性がある。 +.TP +領域エラー (domain error): \fIx\fP が \-1 より小さい +\fIerrno\fP に \fBEDOM\fP が設定される (「バグ」の節も参照)。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) +が上がる。 +.TP +極エラー (pole error): \fIx\fP が \-1 である +\fIerrno\fP に \fBERANGE\fP が設定される (「バグ」の節も参照)。 0 による除算 (divide\-by\-zero) 浮動小数点例外 +(\fBFE_DIVBYZERO\fP) が上がる。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw27 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBlog1p\fP(), +\fBlog1pf\fP(), +\fBlog1pl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +.\" BSD +C99, POSIX.1\-2001, POSIX.1\-2008. +.SH バグ +.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6792 +バージョン 2.22 より前の glibc の実装では、 領域エラーが発生した際に、 \fIerrno\fP に \fBEDOM\fP が設定されなかった。 +.PP +.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6792 +バージョン 2.22 より前の glibc の実装では、 範囲エラーが発生した場合に、 \fIerrno\fP に \fBERANGE\fP が設定されなかった。 +.SH 関連項目 +\fBexp\fP(3), \fBexpm1\fP(3), \fBlog\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/log2.3 b/manual/LDP_man-pages/draft/man3/log2.3 index 1c787e06..5e5af106 100644 --- a/manual/LDP_man-pages/draft/man3/log2.3 +++ b/manual/LDP_man-pages/draft/man3/log2.3 @@ -71,7 +71,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH 説明 -These functions return the base 2 logarithm of \fIx\fP. +これらの関数は \fIx\fP の底を 2 とする対数を返す。 .SH 返り値 成功すると、これらの関数は \fIx\fP の底を 2 とする対数を返す。 .PP @@ -98,7 +98,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD. +\fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠している。 .SH 関連項目 \fBcbrt\fP(3), \fBclog2\fP(3), \fBlog\fP(3), \fBlog10\fP(3), \fBsqrt\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/lround.3 b/manual/LDP_man-pages/draft/man3/lround.3 new file mode 100644 index 00000000..8ad2d8a5 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/lround.3 @@ -0,0 +1,120 @@ +.\" Copyright 2001 Andries Brouwer . +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 2001, 2005 Yuichi SATO +.\" all rights reserved. +.\" Translated Sat Jul 14 11:21:46 JST 2001 +.\" by Yuichi SATO +.\" Updated & Modified Sun Jan 16 06:26:19 JST 2005 +.\" by Yuichi SATO +.\" Updated 2008-09-18, Akihiro MOTOKI +.\" +.TH LROUND 3 2020\-11\-01 "" "Linux Programmer's Manual" +.SH 名前 +lround, lroundf, lroundl, llround, llroundf, llroundl \- 最も近い整数値に丸める +.SH 書式 +.nf +\fB#include \fP +.PP +\fBlong lround(double \fP\fIx\fP\fB);\fP +\fBlong lroundf(float \fP\fIx\fP\fB);\fP +\fBlong lroundl(long double \fP\fIx\fP\fB);\fP +.PP +\fBlong long llround(double \fP\fIx\fP\fB);\fP +\fBlong long llroundf(float \fP\fIx\fP\fB);\fP +\fBlong long llroundl(long double \fP\fIx\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +上記の全ての関数: +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L +.RE +.ad +.SH 説明 +これらの関数は最も近い整数に引き数を丸める。現在の丸め方向 (\fBfenv\fP(3) 参照) に関係なく最も近い整数に丸められ、半分の場合は 0 +から遠い方の整数に丸められることになる。 +.PP +関数 \fBround\fP(3), \fBceil\fP(3) と違い、これらの関数の返り値の型は引き数の型と異なる点に注意すること。 +.SH 返り値 +これらの関数は丸めた整数値を返す。 +.PP +.\" The return value is -(LONG_MAX - 1) or -(LLONG_MAX -1) +\fIx\fP が NaN か無限大の場合、もしくは丸めた値が大き過ぎて \fIlong\fP (\fBll*\fP 関数の場合には \fIlong long\fP) +に格納できない場合、 領域エラー (domain error) が発生し、返り値は不定となる。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 +.PP +以下のエラーが発生する可能性がある。 +.TP +領域エラー (domain error): \fIx\fP が NaN か無限大、もしくは丸めた値が大き過ぎる +.\" .I errno +.\" is set to +.\" .BR EDOM . +不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) が上がる。 +.PP +.\" FIXME . Is it intentional that these functions do not set errno? +.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6797 +これらの関数は \fIerrno\fP を設定しない。 +.SH バージョン +これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw33 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBlround\fP(), +\fBlroundf\fP(), +\fBlroundl\fP(), +.br +\fBllround\fP(), +\fBllroundf\fP(), +\fBllroundl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +C99, POSIX.1\-2001, POSIX.1\-2008. +.SH 関連項目 +\fBceil\fP(3), \fBfloor\fP(3), \fBlrint\fP(3), \fBnearbyint\fP(3), \fBrint\fP(3), +\fBround\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/matherr.3 b/manual/LDP_man-pages/draft/man3/matherr.3 index 143088ad..5dfa1413 100644 --- a/manual/LDP_man-pages/draft/man3/matherr.3 +++ b/manual/LDP_man-pages/draft/man3/matherr.3 @@ -144,15 +144,15 @@ Partial loss of significance が発生した。 .RS .TS l l. -x first argument to function -y second argument to function -fin finite value for argument -neg negative value for argument -int integral value for argument -o/f result overflowed -u/f result underflowed -|x| absolute value of x -X_TLOSS is a constant defined in \fI\fP +x 関数の最初の引き数 +y 関数の二番目の引き数 +fin 引き数の値が無限大 +neg 引き数が負の値 +int 引き数が整数値 +o/f 結果のオーバーフロー +u/f 結果のアンダーフロー +|x| x の絶対値 +X_TLOSS \fI\fP で定義される定数 .TE .RE .\" Details below from glibc 2.8's sysdeps/ieee754/k_standard.c @@ -237,7 +237,7 @@ T{ \fBmatherr\fP() T} Thread safety MT\-Safe .TE -.SH EXAMPLES +.SH 例 以下のサンプルプログラムは \fBlog\fP(3) を呼び出した際の \fBmatherr\fP() の使用法を示したものである。 最初の引き数は \fBlog\fP(3) に渡す浮動小数点数である。 diff --git a/manual/LDP_man-pages/draft/man3/modf.3 b/manual/LDP_man-pages/draft/man3/modf.3 new file mode 100644 index 00000000..9bf98ca3 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/modf.3 @@ -0,0 +1,104 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" 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 +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) +.\" 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) 1997 YOSHINO Takashi +.\" all rights reserved. +.\" Translated Tue Feb 17 11:01:38 JST 1998 +.\" by YOSHINO Takashi +.\" Updated Sun Sep 14 JST 2003 by Kentaro Shirakata +.\" Updated 2008-09-16, Akihiro MOTOKI +.\" +.TH MODF 3 2017\-09\-15 "" "Linux Programmer's Manual" +.SH 名前 +modf, modff, modfl \- 浮動小数点実数から、符号付き整数と小数部分を取り出す関数 +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble modf(double \fP\fIx\fP\fB, double *\fP\fIiptr\fP\fB);\fP +\fBfloat modff(float \fP\fIx\fP\fB, float *\fP\fIiptr\fP\fB);\fP +\fBlong double modfl(long double \fP\fIx\fP\fB, long double *\fP\fIiptr\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBmodff\fP(), \fBmodfl\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad +.SH 説明 +これらの関数は、引数 \fIx\fP を整数部分と小数部分に分割する。 このとき、ふたつの値はともに \fIx\fP と同じ符号を持つ。 整数部分は \fIiptr\fP +が指す場所に格納される。 +.SH 返り値 +これらの関数は \fIx\fP の小数部分を返す。 +.PP +\fIx\fP が NaN の場合、NaN が返され、 \fI*iptr\fP に NaN が設定される。 +.PP +\fIx\fP が正の無限大 (負の無限大) の場合、 +0 (\-0) が返され、 \fI*iptr\fP に正の無限大 (負の無限大) が設定される。 +.SH エラー +エラーは発生しない。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw24 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBmodf\fP(), +\fBmodff\fP(), +\fBmodfl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +C99, POSIX.1\-2001, POSIX.1\-2008. +.PP +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 +.SH 関連項目 +\fBfrexp\fP(3), \fBldexp\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/nan.3 b/manual/LDP_man-pages/draft/man3/nan.3 index b3201c72..410cba54 100644 --- a/manual/LDP_man-pages/draft/man3/nan.3 +++ b/manual/LDP_man-pages/draft/man3/nan.3 @@ -75,8 +75,8 @@ T{ T} Thread safety MT\-Safe locale .TE .SH 準拠 -C99, POSIX.1\-2001, POSIX.1\-2008. See also IEC 559 and the appendix with -recommended functions in IEEE 754/IEEE 854. +C99, POSIX.1\-2001, POSIX.1\-2008. IEC 559 や推奨関数になっている IEEE 754/IEEE 854 +の付録も参照すること。 .SH 関連項目 \fBisnan\fP(3), \fBstrtod\fP(3), \fBmath_error\fP(7) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/nextafter.3 b/manual/LDP_man-pages/draft/man3/nextafter.3 index 9a47bfe8..6e5dc016 100644 --- a/manual/LDP_man-pages/draft/man3/nextafter.3 +++ b/manual/LDP_man-pages/draft/man3/nextafter.3 @@ -117,14 +117,14 @@ T{ T} Thread safety MT\-Safe .TE .SH 準拠 -C99, POSIX.1\-2001, POSIX.1\-2008. This function is defined in IEC 559 (and -the appendix with recommended functions in IEEE 754/IEEE 854). +C99, POSIX.1\-2001, POSIX.1\-2008. この関数は IEC 559 で定義されている (また IEEE 754/IEEE +854 では付録で推奨関数として定義されている)。 .SH バグ glibc バージョン 2.5 以前では、アンダーフローが発生した際に、 これらの関数はアンダーフロー浮動小数点例外 (\fBFE_UNDERFLOW\fP) を上がない。 .PP .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799 -Before glibc version 2.23 these functions did not set \fIerrno\fP. +glibc の 2.23 より前のバージョンでは、これらの関数は \fIerrno\fP を設定しない。 .SH 関連項目 \fBnearbyint\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/nextup.3 b/manual/LDP_man-pages/draft/man3/nextup.3 new file mode 100644 index 00000000..774f9f94 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/nextup.3 @@ -0,0 +1,94 @@ +.\" Copyright (C) 2016, Michael Kerrisk +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH NEXTUP 3 2017\-09\-15 GNU "Linux Programmer's Manual" +.SH 名前 +nextup, nextupf, nextupl, nextdown, nextdownf, nextdownl \- return next +floating\-point number toward positive/negative infinity +.SH 書式 +.nf +\fB#define _GNU_SOURCE\fP /* feature_test_macros(7) 参照 */ +\fB#include \fP +.PP +\fBdouble nextup(double \fP\fIx\fP\fB);\fP +\fBfloat nextupf(float \fP\fIx\fP\fB);\fP +\fBlong double nextupl(long double \fP\fIx\fP\fB);\fP +.PP +\fBdouble nextdown(double \fP\fIx\fP\fB);\fP +\fBfloat nextdownf(float \fP\fIx\fP\fB);\fP +\fBlong double nextdownl(long double \fP\fIx\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.SH 説明 +The \fBnextup\fP(), \fBnextupf\fP(), and \fBnextupl\fP() functions return the next +representable floating\-point number greater than \fIx\fP. +.PP +If \fIx\fP is the smallest representable negative number in the corresponding +type, these functions return \-0. If \fIx\fP is 0, the returned value is the +smallest representable positive number of the corresponding type. +.PP +If \fIx\fP is positive infinity, the returned value is positive infinity. If +\fIx\fP is negative infinity, the returned value is the largest representable +finite negative number of the corresponding type. +.PP +\fIx\fP が NaN の場合、NaN が返される。 +.PP +The value returned by \fInextdown(x)\fP is \fI\-nextup(\-x)\fP, and similarly for +the other types. +.SH 返り値 +.\" .SH ERRORS +「説明」の節を参照。 +.SH バージョン +これらの関数は glibc バージョン 2.24 で初めて登場した。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw36 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBnextup\fP(), +\fBnextupf\fP(), +\fBnextupl\fP(), +.br +\fBnextdown\fP(), +\fBnextdownf\fP(), +\fBnextdownl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +These functions are described in \fIIEEE Std 754\-2008 \- Standard for +Floating\-Point Arithmetic\fP and \fIISO/IEC TS 18661\fP. +.SH 関連項目 +\fBnearbyint\fP(3), \fBnextafter\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/pow.3 b/manual/LDP_man-pages/draft/man3/pow.3 index 6c4d2aca..cc33f9e2 100644 --- a/manual/LDP_man-pages/draft/man3/pow.3 +++ b/manual/LDP_man-pages/draft/man3/pow.3 @@ -71,7 +71,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the value of \fIx\fP raised to the power of \fIy\fP. +これらの関数は \fIx\fP の \fIy\fP 乗の値を返す。 .SH 返り値 成功すると、これらの関数は \fIx\fP の \fIy\fP 乗の値を返す。 .PP @@ -178,15 +178,14 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH バグ .SS "Historical bugs (now fixed)" .\" https://sourceware.org/bugzilla/show_bug.cgi?id=13932 .\" commit c3d466cba1692708a19c6ff829d0386c83a0c6e5 -Before glibc 2.28, on some architectures (e.g., x86\-64) \fBpow\fP() may be -more than 10,000 times slower for some inputs than for other nearby inputs. -This affects only \fBpow\fP(), and not \fBpowf\fP() nor \fBpowl\fP(). This problem -was fixed in glibc 2.28. +バージョン 2.28 より前の glibc では、 (x86\-64 などの) いくつかのアーキテクチャーでは、 \fBpow\fP は、特定の (ごく稀な) +入力に対して、その直近の似たような数字の場合と比べて 10000 倍以上遅くなることがある。 これは \fBpow\fP() でのみ起こることであり、 +\fBpowf\fP() や \fBpowl\fP() では起こらない。この問題は glibc 2.28 で修正された。 .PP .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866 A number of bugs in the glibc implementation of \fBpow\fP() were fixed in diff --git a/manual/LDP_man-pages/draft/man3/pow10.3 b/manual/LDP_man-pages/draft/man3/pow10.3 new file mode 100644 index 00000000..b512acf5 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/pow10.3 @@ -0,0 +1,80 @@ +.\" Copyright 2004 Andries Brouwer (aeb@cwi.nl) +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 2005 Yuichi SATO +.\" all rights reserved. +.\" Translated Sun Jan 30 14:07:37 JST 2005 +.\" by Yuichi SATO +.\" +.TH POW10 3 2017\-09\-15 "" "Linux Programmer's Manual" +.SH 名前 +pow10, pow10f, pow10l \- 底が 10 の累乗関数 +.SH 書式 +.nf +\fB#define _GNU_SOURCE\fP /* feature_test_macros(7) 参照 */ +\fB#include \fP +.PP +\fBdouble pow10(double \fP\fIx\fP\fB);\fP +\fBfloat pow10f(float \fP\fIx\fP\fB);\fP +\fBlong double pow10l(long double \fP\fIx\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.SH 説明 +これらの関数は 10 の \fIx\fP 乗の値を返す。 +.PP +\fBNote well\fP: These functions perform exactly the same task as the functions +described in \fBexp10\fP(3), with the difference that the latter functions are +now standardized in TS\ 18661\-4:2015. Those latter functions should be used +in preference to the functions described in this page. +.SH バージョン +.\" glibc commit 5a80d39d0d2587e9bd8e72f19e92eeb2a66fbe9e +These functions first appeared in glibc in version 2.1. Since glibc 2.27, +the use of these functions in new programs is no longer supported. +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw28 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBpow10\fP(), +\fBpow10f\fP(), +\fBpow10l\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +これらの関数は、非標準の GNU による拡張である。 +.SH 関連項目 +\fBexp10\fP(3), \fBpow\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/remainder.3 b/manual/LDP_man-pages/draft/man3/remainder.3 new file mode 100644 index 00000000..2e40d68a --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/remainder.3 @@ -0,0 +1,171 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" 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 +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" +.\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) +.\" Modified 2002-08-10 Walter Harms +.\" (walter.harms@informatik.uni-oldenburg.de) +.\" Modified 2003-11-18, 2004-10-05 aeb +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 2004 Yuichi SATO +.\" and Copyright (c) 2008 Akihiro MOTOKI +.\" Translated 2004-09-02, Yuichi SATO +.\" Updated 2005-02-26, Akihiro MOTOKI +.\" Modified 2005-02-26, Yuichi SATO +.\" Updated 2008-09-16, Akihiro MOTOKI +.\" +.TH REMAINDER 3 2020\-06\-09 "" "Linux Programmer's Manual" +.SH 名前 +drem, dremf, dreml, remainder, remainderf, remainderl \- 浮動小数点剰余関数 +.SH 書式 +.nf +\fB#include \fP +.PP +/* C99 版 */ +\fBdouble remainder(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB);\fP +\fBfloat remainderf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB);\fP +\fBlong double remainderl(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB);\fP +.PP +/* 廃止された別名 */ +\fBdouble drem(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB);\fP +\fBfloat dremf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB);\fP +\fBlong double dreml(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB);\fP +.PP +.fi +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBremainder\fP(): +.RS 4 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.br +\fBremainderf\fP(), \fBremainderl\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.br +\fBdrem\fP(), \fBdremf\fP(), \fBdreml\fP(): +.RS 4 +/* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +これらの関数は \fIx\fP を \fIy\fP で割った余りを計算する。 返り値は \fIx\fP\-\fIn\fP*\fIy\fP である。 ここで \fIn\fP は \fIx\ /\ y\fP の値を最も近い整数に丸めたものである。 \fIx\fP\-\fIn\fP*\fIy\fP の絶対値が 0.5 の場合、偶数になるように \fIn\fP が選ばれる。 +.PP +これらの関数は、現在の丸めモードの影響を受けない (丸めモードについては \fBfenv\fP(3) を参照)。 +.PP +\fBdrem\fP() 関数はこれと全く同じ動作をする。 +.SH 返り値 +成功すると、これらの関数は浮動小数点の剰余 \fIx\fP\-\fIn\fP*\fIy\fP を返す。 返り値が 0 の場合、その符号は \fIx\fP と同じになる。 +.PP +\fIx\fP か \fIy\fP が NaN の場合、NaN が返される。 +.PP +\fIx\fP が無限大で \fIy\fP が NaN でない場合、 領域エラー (domain error) が発生し、NaN が返される。 +.PP +.\" FIXME . Instead, glibc gives a domain error even if x is a NaN +.\" Interestingly, remquo(3) does not have the same problem. +\fIy\fP がゼロで \fIx\fP が NaN でない場合、 領域エラー (domain error) が発生し、NaN が返される。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 +.PP +以下のエラーが発生する可能性がある。 +.TP +領域エラー (domain error): \fIx\fP が無限大で \fIy\fP が NaN ではない +\fIerrno\fP に \fBEDOM\fP が設定される (「バグ」の節も参照)。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) +が上がる。 +.IP +これらの関数は、この場合に \fIerrno\fP を設定しない。 +.TP +.\" [XXX see bug above] and \fIx\fP is not a NaN +領域エラー: \fIy\fP がゼロ +\fIerrno\fP に \fBEDOM\fP が設定される。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) が上がる。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw26 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBdrem\fP(), +\fBdremf\fP(), +\fBdreml\fP(), +.br +\fBremainder\fP(), +\fBremainderf\fP(), +.br +\fBremainderl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +.\" IEC 60559. +関数 \fBremainder\fP(), \fBremainderf\fP(), \fBremainderl\fP() は C99, POSIX.1\-2001, +POSIX.1\-2008 で規定されている。 +.PP +関数 \fBdrem\fP() は 4.3BSD に由来する。 \fIfloat\fP と \fIlong double\fP 版の \fBdremf\fP() と +\fBdreml\fP() は、Tru64 や glibc2 のようないくつかのシステムに存在する。 これらの関数の使用は避けて、 +\fBremainder\fP() などを使用すること。 +.SH バグ +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779 +glibc 2.15 より前では、 +.PP + remainder(nan(""), 0); +.PP +を行うと、期待通り Nan が返るが、誤って領域エラーが発生した。 glibc 2.15 以降では、エラーなしの Nan (すなわち、領域エラーなし) +が返される。 +.PP +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783 +Before glibc 2.15, \fIerrno\fP was not set to \fBEDOM\fP for the domain error that +occurs when \fIx\fP is an infinity and \fIy\fP is not a NaN. +.SH 例 +"remainder(29.0, 3.0)" を呼び出すと \-1 を返す。 +.SH 関連項目 +\fBdiv\fP(3), \fBfmod\fP(3), \fBremquo\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/rint.3 b/manual/LDP_man-pages/draft/man3/rint.3 new file mode 100644 index 00000000..a467fe74 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/rint.3 @@ -0,0 +1,135 @@ +.\" Copyright 2001 Andries Brouwer . +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 1997 YOSHINO Takashi +.\" and Copyright (c) 2008 Akihiro MOTOKI +.\" Translated Tue Jan 21 20:52:09 JST 1997 +.\" by YOSHINO Takashi +.\" Updated & Modified Fri Jul 6 20:42:59 JST 2001 +.\" by Yuichi SATO +.\" Updated & Modified Sun Jan 16 07:40:37 JST 2005 +.\" by Yuichi SATO +.\" Updated 2008-09-16, Akihiro MOTOKI +.\" +.TH RINT 3 2017\-09\-15 "" "Linux Programmer's Manual" +.SH 名前 +nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl \- 最も近い整数に丸める +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble nearbyint(double \fP\fIx\fP\fB);\fP +\fBfloat nearbyintf(float \fP\fIx\fP\fB);\fP +\fBlong double nearbyintl(long double \fP\fIx\fP\fB);\fP +.PP +\fBdouble rint(double \fP\fIx\fP\fB);\fP +\fBfloat rintf(float \fP\fIx\fP\fB);\fP +\fBlong double rintl(long double \fP\fIx\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBnearbyint\fP(), \fBnearbyintf\fP(), \fBnearbyintl\fP(): +.RS 4 +_POSIX_C_SOURCE\ >=\ 200112L || _ISOC99_SOURCE +.RE +.br +\fBrint\fP(): +.RS 4 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.br +\fBrintf\fP(), \fBrintl\fP(): +.RS 4 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +The \fBnearbyint\fP(), \fBnearbyintf\fP(), and \fBnearbyintl\fP() functions round +their argument to an integer value in floating\-point format, using the +current rounding direction (see \fBfesetround\fP(3)) and without raising the +\fIinexact\fP exception. When the current rounding direction is to nearest, +these functions round halfway cases to the even integer in accordance with +IEEE\-754. +.PP +関数 \fBrint\fP(), \fBrintf\fP(), and \fBrintl\fP() も同じような動作をするが、 結果が引き数と異なる場合に +\fIinexact\fP 例外 (\fBFE_INEXACT\fP) を出す (この例外は \fBfetestexcept\fP(3) 経由で確認可能)。 +.SH 返り値 +これらの関数は丸めた整数値を返す。 +.PP +\fIx\fP が整数、+0、\-0、NaN、無限のいずれかの場合、 \fIx\fP そのものが返される。 +.SH エラー +エラーは発生しない。 POSIX.1\-2001 にはオーバーフローでの範囲エラー (range error) の 記載がある。「注意」の節を参照のこと。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lbw26 lb lb +l l l. +インターフェース 属性 値 +T{ +\fBnearbyint\fP(), +\fBnearbyintf\fP(), +.br +\fBnearbyintl\fP(), +\fBrint\fP(), +.br +\fBrintf\fP(), +\fBrintl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +C99, POSIX.1\-2001, POSIX.1\-2008. +.SH 注意 +SUSv2 と POSIX.1\-2001 にはオーバーフローに関する記述があり、 オーバーフローの場合には、 \fIerrno\fP を \fBERANGE\fP +に設定するか、 \fBFE_OVERFLOW\fP 例外を発生することとされている。 +実際のところ、どの現行のマシンでも結果がオーバーフローを起こすことはないので、 このエラー処理は意味がない。 +(より正確に言うと、オーバーフローは指数部の最大値が 仮数部を表すビットの数より小さい場合にしか起こらない。 IEEE\-754 規格の 32 ビットと +64 ビットの浮動小数では、 指数部の最大値はそれぞれ 128 と 1024 であり、 仮数部のビット数はそれぞれ 24 と 53 である。) +.PP +丸めた値を整数型に格納した場合には、おそらくこの関数ではなく \fBlrint\fP(3) に載っている関数のどれかを使いたいのだろう。 +.SH 関連項目 +\fBceil\fP(3), \fBfloor\fP(3), \fBlrint\fP(3), \fBround\fP(3), \fBtrunc\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/scalb.3 b/manual/LDP_man-pages/draft/man3/scalb.3 index e0490bc0..ca5de0fb 100644 --- a/manual/LDP_man-pages/draft/man3/scalb.3 +++ b/manual/LDP_man-pages/draft/man3/scalb.3 @@ -135,8 +135,7 @@ T} Thread safety MT\-Safe .SH バグ .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804 -Before glibc 2.20, these functions did not set \fIerrno\fP for domain and range -errors. +バージョン 2.20 より前の glibc では、これらの関数は、領域エラーや範囲エラーが発生した場合に \fIerrno\fP を設定しなかった。 .SH 関連項目 \fBldexp\fP(3), \fBscalbln\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/scalbln.3 b/manual/LDP_man-pages/draft/man3/scalbln.3 index 7751fe63..7d4af449 100644 --- a/manual/LDP_man-pages/draft/man3/scalbln.3 +++ b/manual/LDP_man-pages/draft/man3/scalbln.3 @@ -64,7 +64,7 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fBscalbln\fP(), \fBscalblnf\fP(), \fBscalblnl\fP(): .RS _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L - || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* glibc 2.19 以降: */ _DEFAULT_SOURCE .RE .br \fBscalbn\fP(), \fBscalbnf\fP(), \fBscalbnl\fP(): @@ -141,7 +141,7 @@ C99, POSIX.1\-2001, POSIX.1\-2008. その場合は \fBscalbn\fP() は \fBldexp\fP(3) と等価である。 .SH バグ .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 -Before glibc 2.20, these functions did not set \fIerrno\fP for range errors. +バージョン 2.20 より前の glibc では、これらの関数は範囲エラーの場合に \fIerrno\fP を設定しなかった。 .SH 関連項目 \fBldexp\fP(3), \fBscalb\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/signbit.3 b/manual/LDP_man-pages/draft/man3/signbit.3 index 58e011d0..a58977c6 100644 --- a/manual/LDP_man-pages/draft/man3/signbit.3 +++ b/manual/LDP_man-pages/draft/man3/signbit.3 @@ -64,8 +64,8 @@ T{ T} Thread safety MT\-Safe .TE .SH 準拠 -POSIX.1\-2001, POSIX.1\-2008, C99. This function is defined in IEC 559 (and -the appendix with recommended functions in IEEE 754/IEEE 854). +POSIX.1\-2001, POSIX.1\-2008, C99. この関数は IEC 559 で定義されている (また IEEE 754/IEEE +854 では付録で推奨関数として定義されている)。 .SH 関連項目 \fBcopysign\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/significand.3 b/manual/LDP_man-pages/draft/man3/significand.3 new file mode 100644 index 00000000..5e57c2d1 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/significand.3 @@ -0,0 +1,79 @@ +.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de) +.\" +.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) +.\" Distributed under GPL +.\" %%%LICENSE_END +.\" +.\" heavily based on glibc infopages, copyright Free Software Foundation +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 2005 Yuichi SATO +.\" all rights reserved. +.\" Translated Tue Feb 1 07:40:41 JST 2005 +.\" by Yuichi SATO +.\" +.TH SIGNIFICAND 3 2017\-09\-15 GNU "Linux Programmer's Manual" +.SH 名前 +significand, significandf, significandl \- 浮動小数点数の仮数 (mantissa) を取得する +.SH 書式 +\fB#include \fP +.PP +\fBdouble significand(double \fP\fIx\fP\fB);\fP +.br +\fBfloat significandf(float \fP\fIx\fP\fB);\fP +.br +\fBlong double significandl(long double \fP\fIx\fP\fB);\fP +.PP +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBsignificand\fP(), \fBsignificandf\fP(), \fBsignificandl\fP(): +.RS 4 +/* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH 説明 +これらの関数は \fIx\fP の仮数を [1,2) の範囲にして返す。 以下と等しい。 +.PP +.in +4n +.EX +scalb(x, (double) \-ilogb(x)) +.EE +.in +.PP +この関数は主に IEEE 754 への準拠を調べる標準テストで使われる。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lb lb lb +l l l. +インターフェース 属性 値 +T{ +\fBsignificand\fP(), +.br +\fBsignificandf\fP(), +.br +\fBsignificandl\fP() +T} Thread safety MT\-Safe +.TE +.sp 1 +.SH 準拠 +.\" .SH HISTORY +.\" This function came from BSD. +これらの関数は非標準である。。 \fIdouble\fP 版は他の多くのシステムでも利用可能である。 +.SH 関連項目 +\fBilogb\fP(3), \fBscalb\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man3/sin.3 b/manual/LDP_man-pages/draft/man3/sin.3 index 614049f5..b010d5ed 100644 --- a/manual/LDP_man-pages/draft/man3/sin.3 +++ b/manual/LDP_man-pages/draft/man3/sin.3 @@ -74,7 +74,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the sine of \fIx\fP, where \fIx\fP is given in radians. +これらの関数は \fIx\fP の正弦 (サイン) の値を返す。 \fIx\fP はラジアン単位で指定する。 .SH 返り値 成功すると、これらの関数は \fIx\fP の正弦を返す。 .PP @@ -108,7 +108,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH バグ .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781 バージョン 2.10 より前の glibc の実装では、 領域エラーが発生した際に、 \fIerrno\fP に \fBEDOM\fP が設定されなかった。 diff --git a/manual/LDP_man-pages/draft/man3/sincos.3 b/manual/LDP_man-pages/draft/man3/sincos.3 index 99dd7036..335694d0 100644 --- a/manual/LDP_man-pages/draft/man3/sincos.3 +++ b/manual/LDP_man-pages/draft/man3/sincos.3 @@ -33,10 +33,9 @@ sincos, sincosf, sincosl \- 正弦と余弦を同時に計算する .PP \fI\-lm\fP でリンクする。 .SH 説明 -Several applications need sine and cosine of the same angle \fIx\fP. These -functions compute both at the same time, and store the results in \fI*sin\fP -and \fI*cos\fP. Using this function can be more efficient than two separate -calls to \fBsin\fP(3) and \fBcos\fP(3). +アプリケーションの中には、同じ角度 \fIx\fP について正弦と余弦の両方の計算が必要なものがある。 この関数は両者を同時に計算し、その結果を +\fI*sin\fP と \fI*cos\fP に格納する。この関数を使うのは、 \fBsin\fP(3) と \fBcos\fP(3) +の二つの関数を分けて呼び出すより効率的である。 .PP \fIx\fP が NaN の場合、 \fI*sin\fP と \fI*cos\fP に NaN が返される。 .PP @@ -80,8 +79,7 @@ cc \-O \-lm \-fno\-builtin prog.c .in .SH バグ .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467 -Before version 2.22, the glibc implementation did not set \fIerrno\fP to -\fBEDOM\fP when a domain error occurred. +バージョン 2.22 より前の glibc の実装では、 領域エラーが発生した際に、 \fIerrno\fP に \fBEDOM\fP が設定されなかった。 .SH 関連項目 \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/sinh.3 b/manual/LDP_man-pages/draft/man3/sinh.3 index a03c2b66..bca588d6 100644 --- a/manual/LDP_man-pages/draft/man3/sinh.3 +++ b/manual/LDP_man-pages/draft/man3/sinh.3 @@ -74,8 +74,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the hyperbolic sine of \fIx\fP, which is defined -mathematically as: +これらの関数は双曲線正弦 (ハイパボリックサイン) 関数の値を返す。 数学的には以下のように定義されている。 .PP .nf sinh(x) = (exp(x) \- exp(\-x)) / 2 @@ -118,7 +117,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBacosh\fP(3), \fBasinh\fP(3), \fBatanh\fP(3), \fBcosh\fP(3), \fBcsinh\fP(3), \fBtanh\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/sqrt.3 b/manual/LDP_man-pages/draft/man3/sqrt.3 index c86ca2f9..0616a9fd 100644 --- a/manual/LDP_man-pages/draft/man3/sqrt.3 +++ b/manual/LDP_man-pages/draft/man3/sqrt.3 @@ -72,7 +72,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the nonnegative square root of \fIx\fP. +これらの関数は \fIx\fP の平方根のうち負でない方の値を返す。 .SH 返り値 成功すると、これらの関数は \fIx\fP の平方根を返す。 .PP @@ -106,7 +106,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBcbrt\fP(3), \fBcsqrt\fP(3), \fBhypot\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/tan.3 b/manual/LDP_man-pages/draft/man3/tan.3 index fc4c072f..aed3d7dc 100644 --- a/manual/LDP_man-pages/draft/man3/tan.3 +++ b/manual/LDP_man-pages/draft/man3/tan.3 @@ -72,7 +72,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the tangent of \fIx\fP, where \fIx\fP is given in radians. +これらの関数は \fIx\fP の正接（タンジェント）の値を返す。 \fIx\fP はラジアン単位で指定する。 .SH 返り値 成功すると、これらの関数は \fIx\fP の正接 (タンジェント) を返す。 .PP @@ -123,7 +123,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH バグ .\" http://sourceware.org/bugzilla/show_bug.cgi?id=6782 バージョン 2.10 より前の glibc の実装では、 領域エラーが発生した際に、 \fIerrno\fP に \fBEDOM\fP が設定されなかった。 diff --git a/manual/LDP_man-pages/draft/man3/tanh.3 b/manual/LDP_man-pages/draft/man3/tanh.3 index 11e70076..228cb7fb 100644 --- a/manual/LDP_man-pages/draft/man3/tanh.3 +++ b/manual/LDP_man-pages/draft/man3/tanh.3 @@ -71,8 +71,7 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions return the hyperbolic tangent of \fIx\fP, which is defined -mathematically as: +これらの関数は \fIx\fP の双曲線正接 (hyperbolic tangent) 関数を返す。 数学的には以下のように定義されている． .PP .nf tanh(x) = sinh(x) / cosh(x) @@ -107,7 +106,7 @@ T} Thread safety MT\-Safe .SH 準拠 C99, POSIX.1\-2001, POSIX.1\-2008. .PP -The variant returning \fIdouble\fP also conforms to SVr4, 4.3BSD, C89. +\fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBacosh\fP(3), \fBasinh\fP(3), \fBatanh\fP(3), \fBcosh\fP(3), \fBctanh\fP(3), \fBsinh\fP(3) .SH この文書について diff --git a/manual/LDP_man-pages/draft/man3/tgamma.3 b/manual/LDP_man-pages/draft/man3/tgamma.3 index d6b5f4a3..f82a9084 100644 --- a/manual/LDP_man-pages/draft/man3/tgamma.3 +++ b/manual/LDP_man-pages/draft/man3/tgamma.3 @@ -49,12 +49,12 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions calculate the Gamma function of \fIx\fP. +これらの関数は \fIx\fP のガンマ関数を計算する。 .PP ガンマ関数は以下のように定義される: .PP .RS -Gamma(x) = integral from 0 to infinity of t^(x\-1) e^\-t dt + Gamma(x) = t^(x\-1) e^\-t dt の 0 から無限大までの積分 .RE .PP この関数は正でない整数を除くすべての実数に対して定義されている。 非負の整数 \fIm\fP に関して、以下が成立する: @@ -115,8 +115,7 @@ glibc では、C99 や POSIX.1\-2001 で規定されていない以下のエラ .\" .BR ERANGE . .\" glibc (as at 2.8) also supports an inexact .\" exception for various cases. -An underflow floating\-point exception (\fBFE_UNDERFLOW\fP) is raised, and -\fIerrno\fP is set to \fBERANGE\fP. +アンダーフロー浮動小数点例外 (\fBFE_UNDERFLOW\fP) が上がり、 \fIerrno\fP が \fBERANGE\fP に設定される。 .SH バージョン これらの関数は glibc バージョン 2.1 で初めて登場した。 .SH 属性 @@ -142,8 +141,8 @@ C99, POSIX.1\-2001, POSIX.1\-2008. バージョン 2.18 より前の glibc の実装では、 \fIx\fP が負の無限大の場合、 \fIerrno\fP に \fBEDOM\fP が設定されなかった。 .PP .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810 -Before glibc 2.19, the glibc implementation of these functions did not set -\fIerrno\fP to \fBERANGE\fP on an underflow range error. \fIx\fP +glibc 2.19 より前では、これらの関数の glibc 実装はアンダーフロー範囲エラーの場合に \fIerrno\fP に \fBERANGE\fP +を設定しなかった。 .PP .\" glibc バージョン 2.3.3 以前では、 引き数に +0 や \-0 を渡すと、極エラーではなく、 領域エラーを間違って発生していた diff --git a/manual/LDP_man-pages/draft/man3/trunc.3 b/manual/LDP_man-pages/draft/man3/trunc.3 index e4c6f63a..669d12aa 100644 --- a/manual/LDP_man-pages/draft/man3/trunc.3 +++ b/manual/LDP_man-pages/draft/man3/trunc.3 @@ -60,10 +60,9 @@ _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH 説明 -These functions round \fIx\fP to the nearest integer value that is not larger -in magnitude than \fIx\fP. +これらの関数は、絶対値が \fIx\fP よりも大きくない直近の整数値を返す。 .SH 返り値 -These functions return the rounded integer value, in floating format. +これらの関数は、丸められた整数値を、浮動小数点形式で返す。 .PP \fIx\fP が整数、無限大、NaN の場合、\fIx\fP 自身が返される。 .SH エラー diff --git a/manual/LDP_man-pages/draft/man3/y0.3 b/manual/LDP_man-pages/draft/man3/y0.3 new file mode 100644 index 00000000..32e15069 --- /dev/null +++ b/manual/LDP_man-pages/draft/man3/y0.3 @@ -0,0 +1,178 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" 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 +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified Sat Jul 24 19:08:17 1993 by Rik Faith (faith@cs.unc.edu) +.\" Modified 2002-08-25, aeb +.\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB +.\" 2008-07-24, mtk, created this page, based on material from j0.3. +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" +.\" Japanese Version Copyright (c) 2008 Akihiro MOTOKI +.\" all rights reserved. +.\" Translated 2008-09-19, Akihiro MOTOKI , LDP v3.07 +.\" +.TH Y0 3 2020\-06\-09 "" "Linux Programmer's Manual" +.SH 名前 +y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- 第二種ベッセル関数 +.SH 書式 +.nf +\fB#include \fP +.PP +\fBdouble y0(double \fP\fIx\fP\fB);\fP +\fBdouble y1(double \fP\fIx\fP\fB);\fP +\fBdouble yn(int \fP\fIn\fP\fB, double \fP\fIx\fP\fB);\fP +.PP +\fBfloat y0f(float \fP\fIx\fP\fB);\fP +\fBfloat y1f(float \fP\fIx\fP\fB);\fP +\fBfloat ynf(int \fP\fIn\fP\fB, float \fP\fIx\fP\fB);\fP +.PP +\fBlong double y0l(long double \fP\fIx\fP\fB);\fP +\fBlong double y1l(long double \fP\fIx\fP\fB);\fP +\fBlong double ynl(int \fP\fIn\fP\fB, long double \fP\fIx\fP\fB);\fP +.fi +.PP +\fI\-lm\fP でリンクする。 +.PP +.RS -4 +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.RE +.PP +.ad l +\fBy0\fP(), \fBy1\fP(), \fByn\fP(): +.RS 4 +_XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE +.RE +.br +\fBy0f\fP(), \fBy0l\fP(), \fBy1f\fP(), \fBy1l\fP(), \fBynf\fP(), \fBynl\fP(): +.RS 4 +_XOPEN_SOURCE \ >=\ 600 + || (_ISOC99_SOURCE && _XOPEN_SOURCE) + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE +.RE +.ad b +.SH 説明 +関数 \fBy0\fP() と \fBy1\fP() はそれぞれ \fIx\fP の 0 次、1 次の 第二種ベッセル関数の値を返す。 関数 \fByn\fP() は +\fIx\fP の \fIn\fP 次の 第二種ベッセル関数の値を返す。 +.PP +\fIx\fP は正の値でなければならない。 +.PP +関数 \fBy0f\fP(), \fBy1f\fP(), \fBynf\fP() は、 \fIfloat\fP 型を引数に取り、返り値として返す。 関数 \fBy0l\fP(), +\fBy1l\fP(), \fBynl\fP() は、 \fIlong double\fP 型を引数に取り、返り値として返す。 +.SH 返り値 +成功すると、これらの関数は \fIx\fP に対する第二種ベッセル関数の値を返す。 +.PP +\fIx\fP が NaN の場合、NaN が返される。 +.PP +\fIx\fP が負の場合、領域エラー (domain error) が発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP, +\-\fBHUGE_VALL\fP を返す (POSIX.1\-2001 ではこの場合に NaN を返すことも認めている)。 +.PP +\fIx\fP が 0.0 の場合、極エラー (pole error) が発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP, +\-\fBHUGE_VALL\fP を返す。 +.PP +結果がアンダーフローする場合、 範囲エラー (range error) が発生し、 各関数は 0.0 を返す。 +.PP +結果がオーバーフローする場合、範囲エラーが発生し、 各関数はそれぞれ \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP, +\-\fBHUGE_VALL\fP を返す (POSIX.1\-2001 ではこの場合に 0.0 を返すことも認めている)。 +.SH エラー +これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7) を参照のこと。 +.PP +以下のエラーが発生する可能性がある。 +.TP +領域エラー (domain error): \fIx\fP が負である +\fIerrno\fP に \fBEDOM\fP が設定される。 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP) が上がる。 +.TP +極エラー: \fIx\fP が 0.0 +.\" Before POSIX.1-2001 TC2, this was (inconsistently) specified +.\" as a range error. +\fIerrno\fP に \fBERANGE\fP が設定され、 \fBFE_DIVBYZERO\fP 例外が上がる (ただし「バグ」を参照)。 +.TP +範囲エラー (range error): 結果のアンダーフロー +.\" e.g., y0(1e33) on glibc 2.8/x86-32 +.\" This is intended behavior +.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806 +\fIerrno\fP に \fBERANGE\fP が設定される。 このエラーの場合、 \fBfetestexcept\fP(3) は \fBFE_UNDERFLOW\fP +例外を返さない。 +.TP +範囲エラー (range error): 結果のオーバーフロー +.\" e.g., yn(10, 1e-40) on glibc 2.8/x86-32 +\fIerrno\fP に \fBERANGE\fP が設定される (「バグ」の節も参照)。 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP) +が上がる。 +.SH 属性 +この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 +.TS +allbox; +lb lb lb +l l l. +インターフェース 属性 値 +T{ +\fBy0\fP(), +\fBy0f\fP(), +\fBy0l\fP() +T} Thread safety MT\-Safe +T{ +\fBy1\fP(), +\fBy1f\fP(), +\fBy1l\fP() +T} Thread safety MT\-Safe +T{ +\fByn\fP(), +\fBynf\fP(), +\fBynl\fP() +T} Thread safety MT\-Safe +.TE +.SH 準拠 +\fIdouble\fP 型の値を返す関数は、SVr4, 4.3BSD, POSIX.1\-2001, POSIX.1\-2008 に準拠する。 +それ以外は非標準の関数で、BSD にも存在する。 +.SH バグ +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=6807 +Before glibc 2.19, these functions misdiagnosed pole errors: \fIerrno\fP was +set to \fBEDOM\fP, instead of \fBERANGE\fP and no \fBFE_DIVBYZERO\fP exception was +raised. +.PP +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808 +Before glibc 2.17, did not set \fIerrno\fP for "range error: result underflow". +.PP +.\" Actually, 2.3.2 is the earliest test result I have; so yet +.\" to confirm if this error occurs only in 2.3.2. +glibc バージョン 2.3.2 以前では、 領域エラーが発生した場合に、これらの関数は 不正浮動小数点例外 (\fBFE_INVALID\fP) +を上げない。 +.SH 関連項目 +\fBj0\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は +\%https://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/manual/LDP_man-pages/draft/man7/math_error.7 b/manual/LDP_man-pages/draft/man7/math_error.7 index b82e47b3..b162971c 100644 --- a/manual/LDP_man-pages/draft/man7/math_error.7 +++ b/manual/LDP_man-pages/draft/man7/math_error.7 @@ -99,28 +99,22 @@ double\fP に対応する)。 結果の符号は、その関数の数学的な に対応する)。 \fIerrno\fP は \fBERANGE\fP に設定され、「オーバーフロー (overflow)」 浮動小数点例外 (\fBFE_OVERFLOW\fP) が上がる。 .PP -A floating result \fIunderflows\fP if the result is too small to be represented -in the result type. If an underflow occurs, a mathematical function -typically returns 0.0 (C99 says a function shall return "an -implementation\-defined value whose magnitude is no greater than the smallest -normalized positive number in the specified type"). \fIerrno\fP may be set to -\fBERANGE\fP, and an "underflow" (\fBFE_UNDERFLOW\fP) floating\-point exception -may be raised. +浮動小数点のアンダーフローは、 結果が小さ過ぎて、結果を返す型では表現できない場合に発生する。 アンダーフローが発生すると、数学関数は通常は 0.0 +を返す (C99 では、指定された型において最小の正規化された正の値より大きくない 値を持つ実装定義 (implementation\-defined) +の値を返す、となっている)。 \fIerrno\fP は \fBERANGE\fP に設定され、「アンダーフロー」浮動小数点例外 (\fBFE_UNDERFLOW\fP) +が上がる。 .PP いくつかの関数では、渡された引き数の値や、正しい関数の結果が \fIsubnormal (非正規化数)\fP になる場合に範囲エラーを上げる。 subnormal な値とは、0 ではないが、その値が小さすぎて (仮数部の最上位ビットが 1 となる) 標準形では表現できないような値である。 subnormal な値の表現では、仮数部の上位側のビットに 1 個以上の 0 が 含まれることになる。 .SH 注意 .\" See CONFORMANCE in the glibc 2.8 (and earlier) source. -The \fImath_errhandling\fP identifier specified by C99 and POSIX.1 is not -supported by glibc. This identifier is supposed to indicate which of the -two error\-notification mechanisms (\fIerrno\fP, exceptions retrievable via -\fBfetestexcept\fP(3)) is in use. The standards require that at least one be -in use, but permit both to be available. The current (version 2.8) -situation under glibc is messy. Most (but not all) functions raise -exceptions on errors. Some also set \fIerrno\fP. A few functions set -\fIerrno\fP, but don't raise an exception. A very few functions do neither. -See the individual manual pages for details. +C99 と POSIX.1\-2001 で規定されている \fImath_errhandling\fP 識別子は glibc ではサポートされていない。 +この識別子は、2 つのエラー通知機構 (\fIerrno\fP と \fBfetestexcept\fP(3) 経由で取得できる例外) +のうちどちらが使用されているかを通知 することになっている。 標準では、少なくとも一つは使用されることが要求されているが、 +両方とも利用可能であってもよいとされている。 glibc での現在の (バージョン 2.8 での) 状況はかなり混乱している。 ほとんどの関数 +(ただし全部ではない) はエラー時に例外を上げる。 いくつかの関数は \fIerrno\fP も設定する。 \fIerrno\fP +を設定するが、例外を上げない関数も少しだけ存在する。 どちらも行わない関数もごく少数だが存在する。 詳細については個々のマニュアルページを参照のこと。 .PP .\" http://www.securecoding.cert.org/confluence/display/seccode/FLP32-C.+Prevent+or+detect+domain+and+range+errors+in+math+functions \fIerrno\fP と \fBfetestexcept\fP(3) の両方を使ってエラーチェックを行うことで複雑になるのを避けるため、 @@ -139,9 +133,8 @@ r = log(x); .EE .in .PP -The discussion on this page does not apply to the complex mathematical -functions (i.e., those declared by \fI\fP), which in general -are not required to return errors by C99 and POSIX.1. +このページに書かれていることは、 (\fI\fP で宣言されている) 複素数関数にはあてはまらない。 一般に、C99 や +POSIX.1 ではこれらの関数がエラーを返すことを 要求してない。 .PP \fBgcc\fP(1) の \fI\-fno\-math\-errno\fP オプションを使うと、実行ファイルで、標準の実装よりも高速な数学関数の 実装が使用されるようになるが、 エラー時に \fIerrno\fP が設定されない (\fBgcc\fP(1) の \fI\-ffast\-math\fP -- 2.11.0