release/man3/fpclassify.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL, 2002-07-27 Walter Harms
   3 .\" This was done with the help of the glibc manual.
   4 .\"
   5 .\" 2004-10-31, aeb, corrected
   6 .\"*******************************************************************
   7 .\"
   8 .\" This file was generated with po4a. Translate the source file.
   9 .\"
  10 .\"*******************************************************************
  11 .TH FPCLASSIFY 3 2010\-09\-20 "" "Linux Programmer's Manual"
  12 .SH 名前
  13 fpclassify, isfinite, isnormal, isnan, isinf \- 浮動小数点数の分類マクロ
  14 .SH 書式
  15 .nf
  16 \fB#include <math.h>\fP
  17 .sp
  18 \fBint fpclassify(\fP\fIx\fP\fB);\fP
  19 .sp
  20 \fBint isfinite(\fP\fIx\fP\fB);\fP
  21 .sp
  22 \fBint isnormal(\fP\fIx\fP\fB);\fP
  23 .sp
  24 \fBint isnan(\fP\fIx\fP\fB);\fP
  25 .sp
  26 \fBint isinf(\fP\fIx\fP\fB);\fP
  27 .fi
  28 .sp
  29 \fI\-lm\fP でリンクする。
  30 .sp
  31 .in -4n
  32 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  33 .in
  34 .sp
  35 .\" I haven't fully grokked the source to determine the FTM requirements;
  36 .\" in part, the following has been tested by experiment.
  37 .ad l
  38 \fBfpclassify\fP(), \fBisfinite\fP(), \fBisnormal\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 \fBisnan\fP():
  45 .RS 4
  46 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE ||
  47 _POSIX_C_SOURCE\ >=\ 200112L;
  48 .br
  49 or \fIcc\ \-std=c99\fP
  50 .RE
  51 \fBisinf\fP():
  52 .RS 4
  53 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE
  54 || _POSIX_C_SOURCE\ >=\ 200112L;
  55 .br
  56 or \fIcc\ \-std=c99\fP
  57 .RE
  58 .ad
  59 .SH 説明
  60 浮動小数点数は無限大や NaN のような特別な値を持つことができる。 マクロ \fBfpclassify(\fP\fIx\fP\fB)\fP で \fIx\fP
  61 がどのような種別かを知ることができる。 マクロは任意の浮動小数点数表現を引き数としてとることができる。 結果は以下の値のいずれか一つである:
  62 .TP  14
  63 \fBFP_NAN\fP
  64 \fIx\fP が "Not a Number" である (数値ではない)。
  65 .TP
  66 \fBFP_INFINITE\fP
  67 \fIx\fP が正の無限大または負の無限大である。
  68 .TP
  69 \fBFP_ZERO\fP
  70 \fIx\fP が 0 である。
  71 .TP
  72 \fBFP_SUBNORMAL\fP
  73 \fIx\fP を正規化形式で表現するには小さすぎる。
  74 .TP
  75 \fBFP_NORMAL\fP
  76 上記のどれにも当てはまらない場合であり、 値は通常の浮動小数点数であるはずだ。
  77 .LP
  78 他のマクロは、いくつかの標準的な問いに対して、簡単な答えを提供する。
  79 .TP  14
  80 \fBisfinite(\fP\fIx\fP\fB)\fP
  81 以下の場合に 0 以外の値を返す。
  82 .br
  83 (fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)
  84 .TP
  85 \fBisnormal(\fP\fIx\fP\fB)\fP
  86 (fpclassify(x) == FP_NORMAL)  の場合に 0 以外の値を返す。
  87 .TP
  88 \fBisnan(\fP\fIx\fP\fB)\fP
  89 (fpclassify(x) == FP_NAN)  の場合に 0 以外の値を返す。
  90 .TP
  91 \fBisinf(\fP\fIx\fP\fB)\fP
  92 \fIx\fP が正の無限大の場合は 1 を、 負の無限大の場合は \-1 を返す。
  93 .SH 準拠
  94 C99, POSIX.1.
  95
  96 \fBisinf\fP()  に関して、標準規格で定められているのは、 返り値が 0 以外になるのは引き数が無限大の場合だけということだけである。
  97 .SH 注意
  98 glibc 2.01 以前では、 \fBisinf\fP()  は \fIx\fP が正の無限大か負の無限大の場合、 0 以外の値 (実際には 1) を返す
  99 (C99 の要求仕様で決まっているのは 0 以外の値を返すということだけである)。
 100 .SH 関連項目
 101 \fBfinite\fP(3), \fBINFINITY\fP(3), \fBisgreater\fP(3), \fBsignbit\fP(3)