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 .\"
  16 .\" Japanese Version Copyright (c) 2004-2005 Yuichi SATO
  17 .\"         all rights reserved.
  18 .\" Translated Fri Aug 20 04:03:26 JST 2004
  19 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  20 .\" Updated & Modified Sat Jan 15 02:32:55 JST 2005 by Yuichi SATO
  21 .\" Updated 2008-09-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  22 .\" Updated 2012-05-29, Akihiro MOTOKI <amotoki@gmail.com>
  23 .\"
  24 .TH ISGREATER 3 2014\-01\-27 "" "Linux Programmer's Manual"
  25 .SH 名前
  26 isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered \-
  27 NaN に対して例外を発生せずに、浮動小数点数の大小関係の判定を行う
  28 .SH 書式
  29 .nf
  30 \fB#include <math.h>\fP
  31 .sp
  32 \fBint isgreater(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  33 .sp
  34 \fBint isgreaterequal(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  35 .sp
  36 \fBint isless(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  37 .sp
  38 \fBint islessequal(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  39 .sp
  40 \fBint islessgreater(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  41 .sp
  42 \fBint isunordered(\fP\fIx\fP\fB, \fP\fIy\fP\fB);\fP
  43 .fi
  44 .sp
  45 \fI\-lm\fP でリンクする。
  46 .sp
  47 .in -4n
  48 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  49 .in
  50 .sp
  51 .ad l
  52 ここで説明する全ての関数:
  53 .RS
  54 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L;
  55 .br
  56 or \fIcc\ \-std=c99\fP
  57 .RE
  58 .ad b
  59 .SH 説明
  60 (\fB<\fP、「小なり」のような) 通常の関係操作 (relation operations) は、
  61 オペランドの一方が NaN の場合には失敗する。 これは例外の原因になる。
  62 これを避けるため、C99 では以下のリストに示すマクロを定義している。
  63
  64 これらのマクロでは、引き数を 1 回だけ評価することが保証されている。
  65 引き数には実数の浮動小数点数型を指定しなければならない。
  66 (注意: これらのマクロの引き数に整数値を渡さないこと。なぜなら
  67 整数値の引き数は実数の浮動小数点型に変換されないからである。)
  68 .TP
  69 \fBisgreater\fP()
  70 \fI(x)\ >\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  71 .TP
  72 \fBisgreaterequal\fP()
  73 \fI(x)\ >=\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  74 .TP
  75 \fBisless\fP()
  76 \fI(x)\ <\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  77 .TP
  78 \fBislessequal\fP()
  79 \fI(x)\ <=\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  80 .TP
  81 \fBislessgreater\fP()
  82 \fI(x)\ < (y) || (x) >\ (y)\fP を決定する。 \fIx\fP または \fIy\fP が NaN でも例外を発生しない。
  83 このマクロは \fIx\ !=\ y\fP と等価ではない。 なぜなら、この評価式は \fIx\fP または \fIy\fP が NaN の場合に true
  84 となるためである。
  85 .TP
  86 \fBisunordered\fP()
  87 引き数が unordered かどうか、つまり引き数の少なくとも一方が NaN かどうか を判定する。
  88 .SH 返り値
  89 \fBisunordered\fP()  以外のマクロは関係操作の結果を返す。 一方の引き数が NaN の場合、これらのマクロは 0 を返す。
  90
  91 \fBisunordered\fP()  は \fIx\fP か \fIy\fP が NaN の場合 1 を、 それ以外の場合 0 を返す。
  92 .SH エラー
  93 エラーは発生しない。
  94 .SH 属性
  95 .SS "マルチスレッディング (pthreads(7) 参照)"
  96 マクロ \fBisgreater\fP(), \fBisgreaterequal\fP(), \fBisless\fP(), \fBislessequal\fP(),
  97 \fBislessgreater\fP(), \fBisunordered\fP() はスレッドセーフである。
  98 .SH 準拠
  99 C99, POSIX.1\-2001.
 100 .SH 注意
 101 これらの関数は全てのハードウェアでサポートされているわけではない。 サポートされていない場合は、マクロでエミュレートされる。
 102 エミュレートされる場合は、性能上での不利となる。 NaN について心配しなくて構わない場合は、 これらの関数を使わないこと。
 103 .SH 関連項目
 104 \fBfpclassify\fP(3), \fBisnan\fP(3)
 105 .SH この文書について
 106 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.65 の一部
 107 である。プロジェクトの説明とバグ報告に関する情報は
 108 http://www.kernel.org/doc/man\-pages/ に書かれている。