release/man3/fma.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   3 .\"     <mtk.manpages@gmail.com>
   4 .\"
   5 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   6 .\" Distributed under GPL
   7 .\" %%%LICENSE_END
   8 .\"
   9 .\" Modified 2004-11-15, Added further text on FLT_ROUNDS
  10 .\"     as suggested by AEB and Fabian Kreutz
  11 .\"
  12 .\"*******************************************************************
  13 .\"
  14 .\" This file was generated with po4a. Translate the source file.
  15 .\"
  16 .\"*******************************************************************
  17 .TH FMA 3 2010\-09\-20 "" "Linux Programmer's Manual"
  18 .SH 名前
  19 fma, fmaf, fmal \- 浮動小数点数の積と和を計算する
  20 .SH 書式
  21 .nf
  22 \fB#include <math.h>\fP
  23 .sp
  24 \fBdouble fma(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB, double \fP\fIz\fP\fB);\fP
  25 .br
  26 \fBfloat fmaf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB, float \fP\fIz\fP\fB);\fP
  27 .br
  28 \fBlong double fmal(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB, long double \fP\fIz\fP\fB);\fP
  29 .fi
  30 .sp
  31 \fI\-lm\fP でリンクする。
  32 .sp
  33 .in -4n
  34 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  35 .in
  36 .sp
  37 .ad l
  38 \fBfma\fP(), \fBfmaf\fP(), \fBfmal\fP():
  39 .RS 4
  40 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L;
  41 .br
  42 or \fIcc\ \-std=c99\fP
  43 .RE
  44 .ad
  45 .SH 説明
  46 \fBfma\fP()  関数は \fIx\fP * \fIy\fP + \fIz\fP を計算する。 結果は、一つの三項演算として現在の丸めモードにしたがって丸められる
  47 (\fBfenv\fP(3)  参照)。
  48 .SH 返り値
  49 これらの関数は \fIx\fP * \fIy\fP + \fIz\fP の、一つの三項演算として丸められた値を返す。
  50
  51 \fIx\fP か \fIy\fP が NaN の場合、NaN が返される。
  52
  53 \fIy\fP の \fIx\fP 倍がちょうど無限大で、 \fIz\fP がそれとは反対の符号の無限大の場合、 領域エラー (domain error)
  54 が発生し、NaN が返される。
  55
  56 .\" POSIX.1-2008 allows some possible differences for the following two
  57 .\" domain error cases, but on Linux they are treated the same (AFAICS).
  58 .\" Nevertheless, we'll mirror POSIX.1 and describe the two cases
  59 .\" separately.
  60 .\" POSIX.1 says that a NaN or an implementation-defined value shall
  61 .\" be returned for this case.
  62 \fIx\fP と \fIy\fP のうち一方が無限大で、もう一方が 0 で、 \fIz\fP が NaN でない場合、領域エラーが発生し、NaN が返される。
  63
  64 .\" POSIX.1 makes the domain error optional for this case.
  65 \fIx\fP と \fIy\fP のうち一方が無限大で、もう一方が 0 で、 \fIz\fP が NaN の場合、領域エラーが発生し、NaN が返される。
  66
  67 \fIy\fP の \fIx\fP 倍が 0 の無限大倍 (もしくはその逆) ではなく、 \fIz\fP が NaN の場合、NaN が返される。
  68
  69 結果がオーバーフローする場合、範囲エラー (range error) が発生し、 正しい符号の無限大が返される。
  70
  71 結果がアンダーフローする場合、 範囲エラーが発生し、符号付きの 0 が返される。
  72 .SH エラー
  73 これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7)  を参照のこと。
  74 .PP
  75 以下のエラーが発生する可能性がある。
  76 .TP
  77 領域エラー: \fIx\fP * \fIy\fP + \fIz\fP か \fIx\fP * \fIy\fP が無効で、\fIz\fP が NaN ではない
  78 .\" .I errno
  79 .\" is set to
  80 .\" .BR EDOM .
  81 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP)  が上がる。
  82 .TP
  83 範囲エラー (range error): 結果のオーバーフロー
  84 .\" .I errno
  85 .\" is set to
  86 .\" .BR ERANGE .
  87 オーバーフロー浮動小数点例外 (\fBFE_OVERFLOW\fP)  が上がる。
  88 .TP
  89 範囲エラー (range error): 結果のアンダーフロー
  90 .\" .I errno
  91 .\" is set to
  92 .\" .BR ERANGE .
  93 アンダーフロー浮動小数点例外 (\fBFE_UNDERFLOW\fP)  が上がる。
  94 .PP
  95 .\" FIXME . Is it intentional that these functions do not set errno?
  96 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801
  97 これらの関数は \fIerrno\fP を設定しない。
  98 .SH バージョン
  99 これらの関数は glibc バージョン 2.1 で初めて登場した。
 100 .SH 準拠
 101 C99, POSIX.1\-2001.
 102 .SH 関連項目
 103 \fBremainder\fP(3), \fBremquo\fP(3)
 104 .SH この文書について
 105 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 106 である。プロジェクトの説明とバグ報告に関する情報は
 107 http://www.kernel.org/doc/man\-pages/ に書かれている。