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

C#のInt32.CompareToメソッドは、現在のインスタンス（呼び出し元の整数値）と、指定されたオブジェクトまたはInt32型の値を比較し、両者の相対的な大小関係を示す整数値を返します。数値の並べ替えや条件分岐など、さまざまな場面で活用できる基本的なメソッドです。

構文

Int32.CompareToメソッドの構文は以下の通りです。

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

1つ目の構文では、引数valとして比較対象の整数値を指定します。2つ目の構文では、比較対象としてオブジェクトを指定します。

戻り値の意味

• 0未満の値：現在のインスタンスが比較対象の値より小さい場合
• 0：現在のインスタンスが比較対象の値と等しい場合
• 0より大きい値：現在のインスタンスが比較対象の値より大きい場合

使用例1：異なる値を比較する場合

まず、Int32.CompareToメソッドを使って異なる2つの整数値を比較する例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      int val1 = 20;
      int val2 = 18;
      Console.WriteLine("Value 1 = "+val1);
      Console.WriteLine("Value 2 = "+val2);
      Console.WriteLine("Return value (comparison) = "+val1.CompareTo(val2));
   }
}

実行結果

上記のコードを実行すると、次のような出力が得られます。

Value 1 = 20
Value 2 = 18
Return value (comparison) = 1

この例では、val1（20）がval2（18）よりも大きいため、CompareToメソッドは1（0より大きい値）を返しています。

使用例2：同じ値を比較する場合

続いて、同じ値同士を比較した場合の動作を確認してみましょう。

using System;
public class Demo {
   public static void Main(){
      int val1 = 50;
      int val2 = 50;
      Console.WriteLine("Value 1 = "+val1);
      Console.WriteLine("Value 2 = "+val2);
      Console.WriteLine("Return value (comparison) = "+val1.CompareTo(val2));
   }
}

実行結果

このコードを実行すると、以下の出力になります。

Value 1 = 50
Value 2 = 50
Return value (comparison) = 0

val1（50）とval2（50）が等しいため、CompareToメソッドは0を返します。

まとめ

Int32.CompareToメソッドを使うことで、2つの整数値の大小関係を簡単に判定できます。戻り値が「負の値・0・正の値」のいずれであるかを確認することで、現在のインスタンスが比較対象に対して「小さい・等しい・大きい」を判断できます。ソート処理や値の検証など、実務でも頻繁に使われる重要なメソッドなので、ぜひ使い方をマスターしておきましょう。