C/C++のisgreaterequal()関数とは？使い方と実行例を解説

isgreaterequal()関数とは

isgreaterequal()関数は、第1引数が第2引数以上であるかどうかを判定するために使用される関数です。C言語では「math.h」ヘッダーファイルで宣言されており、C++でも同様に利用できます。条件が成立した場合はtrue（1）を返し、成立しない場合はfalse（0）を返します。

通常の比較演算子（>=）と異なり、この関数はNaN（非数）が引数として渡された場合に無効な例外を発生させないため、浮動小数点数を安全に比較したい場面で特に役立ちます。

構文

bool isgreaterequal(value1 , value2);

各パラメータの意味は以下の通りです。

value1 − 第1引数。value2と比較される値です。

value2 − 第2引数。value1がこの値以上であるかどうかの判定に使用されます。

サンプルプログラム1：val1がval2以上の場合

#include<iostream>
#include<math.h>
using namespace std;
int main() {
    int val1 = 28;
    int val2 = 8;
    bool result;
    result = isgreaterequal(val1, val2);
    cout << "val1 isgreaterequal than val2 : " << result << endl;
    return 0;
}

実行結果

val1 isgreaterequal than val2 : 1

上記の例では、2つの値を比較しています。この関数は内部的に「value1 > value2 || value1 == value2」の判定を行います。いずれか一方でもtrueであれば1を返し、どちらも成立しない場合は0を返します。ここではval1（28）がval2（8）より大きいため、結果は1となっています。

サンプルプログラム2：val1がval2より小さい場合

次に、第1引数が第2引数より小さい場合の動作を確認してみましょう。

#include<iostream>
#include<math.h>
using namespace std;
int main() {
    int val1 = 5;
    int val2 = 8;
    bool result;
    result = isgreaterequal(val1, val2);
    cout << "val1 isgreaterequal than val2 : " << result << endl;
    return 0;
}

実行結果

val1 isgreaterequal than val2 : 0

この例では、val1（5）がval2（8）より小さいため、「val1 > val2」も「val1 == val2」も成立せず、isgreaterequal()は0（false）を返します。

まとめ

isgreaterequal()関数を使うことで、「以上」の比較を簡潔かつ安全に行うことができます。特に浮動小数点数の比較においてNaNを含むデータを扱う可能性がある場合は、比較演算子の代わりにこの関数を使用することで、より堅牢なコードを書くことができます。