release/man3/fpclassify.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   4 .\" Distributed under GPL
   5 .\" %%%LICENSE_END
   6 .\"
   7 .\" This was done with the help of the glibc manual.
   8 .\"
   9 .\" 2004-10-31, aeb, corrected
  10 .\"*******************************************************************
  11 .\"
  12 .\" This file was generated with po4a. Translate the source file.
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" Japanese Version Copyright (c) 2004-2005 Yuichi SATO
  17 .\"         all rights reserved.
  18 .\" Translated 2004-07-27, Yuichi SATO <ysato444@yahoo.co.jp>
  19 .\" Updated & Modified 2005-01-10, Yuichi SATO
  20 .\" Updated & Modified 2005-09-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  21 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  22 .\"
  23 .TH FPCLASSIFY 3 2013\-08\-06 "" "Linux Programmer's Manual"
  24 .SH 名前
  25 fpclassify, isfinite, isnormal, isnan, isinf \- 浮動小数点数の分類マクロ
  26 .SH 書式
  27 .nf
  28 \fB#include <math.h>\fP
  29 .sp
  30 \fBint fpclassify(\fP\fIx\fP\fB);\fP
  31 .sp
  32 \fBint isfinite(\fP\fIx\fP\fB);\fP
  33 .sp
  34 \fBint isnormal(\fP\fIx\fP\fB);\fP
  35 .sp
  36 \fBint isnan(\fP\fIx\fP\fB);\fP
  37 .sp
  38 \fBint isinf(\fP\fIx\fP\fB);\fP
  39 .fi
  40 .sp
  41 \fI\-lm\fP でリンクする。
  42 .sp
  43 .in -4n
  44 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  45 .in
  46 .sp
  47 .\" I haven't fully grokked the source to determine the FTM requirements;
  48 .\" in part, the following has been tested by experiment.
  49 .ad l
  50 \fBfpclassify\fP(), \fBisfinite\fP(), \fBisnormal\fP():
  51 .RS 4
  52 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L;
  53 .br
  54 or \fIcc\ \-std=c99\fP
  55 .RE
  56 \fBisnan\fP():
  57 .RS 4
  58 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE ||
  59 _POSIX_C_SOURCE\ >=\ 200112L;
  60 .br
  61 or \fIcc\ \-std=c99\fP
  62 .RE
  63 \fBisinf\fP():
  64 .RS 4
  65 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE
  66 || _POSIX_C_SOURCE\ >=\ 200112L;
  67 .br
  68 or \fIcc\ \-std=c99\fP
  69 .RE
  70 .ad
  71 .SH 説明
  72 浮動小数点数は無限大や NaN のような特別な値を持つことができる。 マクロ \fBfpclassify(\fP\fIx\fP\fB)\fP で \fIx\fP
  73 がどのような種別かを知ることができる。 マクロは任意の浮動小数点数表現を引き数としてとることができる。 結果は以下の値のいずれか一つである:
  74 .TP  14
  75 \fBFP_NAN\fP
  76 \fIx\fP が "Not a Number" である (数値ではない)。
  77 .TP
  78 \fBFP_INFINITE\fP
  79 \fIx\fP が正の無限大または負の無限大である。
  80 .TP
  81 \fBFP_ZERO\fP
  82 \fIx\fP が 0 である。
  83 .TP
  84 \fBFP_SUBNORMAL\fP
  85 \fIx\fP を正規化形式で表現するには小さすぎる。
  86 .TP
  87 \fBFP_NORMAL\fP
  88 上記のどれにも当てはまらない場合であり、 値は通常の浮動小数点数であるはずだ。
  89 .LP
  90 他のマクロは、いくつかの標準的な問いに対して、簡単な答えを提供する。
  91 .TP  14
  92 \fBisfinite(\fP\fIx\fP\fB)\fP
  93 以下の場合に 0 以外の値を返す。
  94 .br
  95 (fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)
  96 .TP
  97 \fBisnormal(\fP\fIx\fP\fB)\fP
  98 (fpclassify(x) == FP_NORMAL)  の場合に 0 以外の値を返す。
  99 .TP
 100 \fBisnan(\fP\fIx\fP\fB)\fP
 101 (fpclassify(x) == FP_NAN)  の場合に 0 以外の値を返す。
 102 .TP
 103 \fBisinf(\fP\fIx\fP\fB)\fP
 104 \fIx\fP が正の無限大の場合は 1 を、 負の無限大の場合は \-1 を返す。
 105 .SH 属性
 106 .SS "マルチスレッディング (pthreads(7) 参照)"
 107 マクロ \fBfpclassify\fP(), \fBisfinite\fP(), \fBisnormal\fP(), \fBisnan\fP(), \fBisinf\fP()
 108 はスレッドセーフである。
 109 .SH 準拠
 110 C99, POSIX.1.
 111
 112 \fBisinf\fP()  に関して、標準規格で定められているのは、 返り値が 0 以外になるのは引き数が無限大の場合だけということだけである。
 113 .SH 注意
 114 glibc 2.01 以前では、 \fBisinf\fP()  は \fIx\fP が正の無限大か負の無限大の場合、 0 以外の値 (実際には 1) を返す
 115 (C99 の要求仕様で決まっているのは 0 以外の値を返すということだけである)。
 116 .SH 関連項目
 117 \fBfinite\fP(3), \fBINFINITY\fP(3), \fBisgreater\fP(3), \fBsignbit\fP(3)
 118 .SH この文書について
 119 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部
 120 である。プロジェクトの説明とバグ報告に関する情報は
 121 http://www.kernel.org/doc/man\-pages/ に書かれている。