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