release/man3/isgreater.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\" 2002-07-27 Walter Harms
   4 .\" this was done with the help of the glibc manual
   5 .\"
   6 .\"*******************************************************************
   7 .\"
   8 .\" This file was generated with po4a. Translate the source file.
   9 .\"
  10 .\"*******************************************************************
  11 .TH ISGREATER 3 2010\-09\-20 "" "Linux Programmer's Manual"
  12 .SH 名前
  13 isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered \-
  14 NaN に対して例外を発生せずに、浮動小数点数の大小関係の判定を行う
  15 .SH 書式
  16 .nf
  17 \fB#include <math.h>\fP
  18 .sp
  19 \fBint isgreater(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  20 .sp
  21 \fBint isgreaterequal(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  22 .sp
  23 \fBint isless(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  24 .sp
  25 \fBint islessequal(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  26 .sp
  27 \fBint islessgreater(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  28 .sp
  29 \fBint isunordered(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  30 .fi
  31 .sp
  32 \fI\-lm\fP でリンクする。
  33 .sp
  34 .in -4n
  35 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  36 .in
  37 .sp
  38 .ad l
  39 ここで説明する全ての関数:
  40 .RS
  41 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L;
  42 .br
  43 or \fIcc\ \-std=c99\fP
  44 .RE
  45 .ad b
  46 .SH 説明
  47 (\fB<\fP、「小なり」のような) 通常の関係操作 (relation operations) は、 オペランドの一方が NaN
  48 の場合には失敗する。 これは例外の原因になる。 これを避けるため、C99 では次のようなマクロを定義している。 これらのマクロはオペランドを 1
  49 回だけ評価することが保証されている。 オペランドには任意の実数の浮動小数点数型を指定できる。
  50 .TP
  51 \fBisgreater\fP()
  52 \fI(x)\ >\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  53 .TP
  54 \fBisgreaterequal\fP()
  55 \fI(x)\ >=\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  56 .TP
  57 \fBisless\fP()
  58 \fI(x)\ <\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  59 .TP
  60 \fBislessequal\fP()
  61 \fI(x)\ <=\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  62 .TP
  63 \fBislessgreater\fP()
  64 \fI(x)\ < (y) || (x) >\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  65 このマクロは \fIx\ !=\ y\fP と等価ではない。 なぜなら、この評価式は \fIx\fP または \fIy\fP が NaN の場合に true
  66 となるためである。
  67 .TP
  68 \fBisunordered\fP()
  69 引き数が unordered かどうか、つまり引き数の少なくとも一方が NaN かどうか を判定する。
  70 .SH 返り値
  71 \fBisunordered\fP()  以外のマクロは関係操作の結果を返す。 一方の引き数が NaN の場合、これらのマクロは 0 を返す。
  72
  73 \fBisunordered\fP()  は \fIx\fP か \fIy\fP が NaN の場合 1 を、 それ以外の場合 0 を返す。
  74 .SH エラー
  75 エラーは発生しない。
  76 .SH 準拠
  77 C99, POSIX.1\-2001.
  78 .SH 注意
  79 これらの関数は全てのハードウェアでサポートされているわけではない。 サポートされていない場合は、マクロでエミュレートされる。
  80 エミュレートされる場合は、性能上での不利となる。 NaN について心配しなくて構わない場合は、 これらの関数を使わないこと。
  81 .SH 関連項目
  82 \fBfpclassify\fP(3), \fBisnan\fP(3)