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