C#のInt32.Equals()メソッドとは？構文とサンプルコードでわかりやすく解説

C#のInt32.Equals()メソッドは、現在のインスタンス（int型の値）が、指定されたオブジェクトまたは別のInt32値と等しいかどうかを判定し、その結果をbool型（true / false）で返します。

数値同士の比較を行いたい場面はプログラミングにおいて非常に多く、Equals()メソッドを理解しておくことは、条件分岐やデータ検証の実装に役立ちます。

構文

Int32.Equals()メソッドには、以下の2つのオーバーロードが用意されています。

public bool Equals (int ob);
public override bool Equals (object ob);

パラメータの説明

• 1つ目の構文： 引数 ob には、現在のインスタンスと比較するInt32（int型）の値を指定します。
• 2つ目の構文： 引数 ob には、現在のインスタンスと比較するobject型のインスタンスを指定します。

戻り値

比較した値が等しければ true、等しくなければ false を返します。

使用例1：基本的な数値の比較

まずは、2つのint型変数をEquals()メソッドで比較する基本的な例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      int val1 = 299;
      int val2 = 450;
      Console.WriteLine("Value1 = "+val1);
      Console.WriteLine("Value2 = "+val2);
      Console.WriteLine("Are they equal? = "+val1.Equals(val2));
   }
}

出力結果

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

Value1 = 299
Value2 = 450
Are they equal? = False

val1（299）とval2（450）は異なる値であるため、Equals()メソッドはfalseを返しています。

使用例2：Int32.MinValueとの比較

次に、int型が取り得る最小値である Int32.MinValue を使った例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      int val1 = Int32.MinValue;
      int val2 = 0;
      Console.WriteLine("Value1 = "+val1);
      Console.WriteLine("Value2 = "+val2);
      Console.WriteLine("Are they equal? = "+val1.Equals(val2));
   }
}

出力結果

実行結果は以下の通りです。

Value1 = -2147483648
Value2 = 0
Are they equal? = False

Int32.MinValue は -2147483648（約-21億）というint型の最小値を表します。これと0を比較しているため、結果はfalseとなります。

まとめ

Int32.Equals()メソッドを使うことで、int型の値同士が等しいかどうかを簡単に判定できます。==演算子でも同様の比較は可能ですが、Equals()メソッドはobject型との比較にも対応しており、ジェネリックコードやインターフェース経由での比較など、より柔軟なシーンで活用できます。