C#のSingle.CompareTo()メソッドの使い方を実例付きで解説

C#のSingle.CompareTo()メソッドは、現在のインスタンス（呼び出し元の値）を、指定されたオブジェクトまたは別のSingleインスタンスと比較し、両者の大小関係を示す整数値を返すメソッドです。

戻り値の意味は以下の通りです。

• 1つ目のインスタンスが2つ目より小さい場合：0未満の値
• 両者が等しい場合：0
• 1つ目のインスタンスが2つ目より大きい場合：0より大きい値

構文

このメソッドには2つのオーバーロードがあります。

public int CompareTo (float val);
public int CompareTo (object val);

1つ目の構文のvalパラメータには、比較対象となる単精度浮動小数点数（float）を指定します。2つ目の構文では、比較対象として任意のオブジェクトを指定できます。

使用例1：float型同士の比較

まず、2つのfloat値を比較する基本的な例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        float f1 = 50.7f;
        float f2 = 50.7f;
        Console.WriteLine("Value1 = "+f1);
        Console.WriteLine("Value1 = "+f2);
        Console.WriteLine("Is f1 and f2 equal? = "+f1.CompareTo(f2));
    }
}

出力結果

Value1 = 50.7
Value1 = 50.7
Is f1 and f2 equal? = 0

両者の値が等しいため、CompareTo()メソッドは「0」を返しています。

使用例2：object型との比較

次に、object型にボックス化された値と比較する例を紹介します。戻り値を使って条件分岐を行うことで、大小関係を明確に判定できます。

using System;
public class Demo {
    public static void Main(){
        float f1 = 50.7f;
        object f2 = 50.7f;
        Console.WriteLine("Value1 = "+f1);
        Console.WriteLine("Value1 = "+f2);
        int res = f1.CompareTo(f2);
        if (res > 0)
            Console.WriteLine("f1 > f2");
        else if (res < 0)
            Console.WriteLine("f1 < f2");
        else
            Console.WriteLine("f1 = f2");
    }
}

出力結果

Value1 = 50.7
Value1 = 50.7
f1 = f2

戻り値resが0だったため、「f1 = f2」と表示されました。このように、CompareTo()メソッドの戻り値をif文で判定することで、数値の大小関係を柔軟に処理できます。