C#のInt32.MinValueフィールドとは？構文と実装例を解説

C#におけるInt32.MinValueフィールドは、Int32型で表現できる最小値「-2147483648」を表す定数フィールドです。この値は読み取り専用であり、プログラム内でint型の下限値として利用できます。

なお、対になるInt32.MaxValueフィールドは最大値「2147483647」を表します。

構文

Int32.MinValueフィールドの構文は以下の通りです。

public const int MinValue = -2147483648;

例1：Int32.MinValueの基本的な使い方

まずは、Int32.MinValueとInt32.MaxValueを実際に表示する基本的な例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      int val1 = 23;
      int val2 = 0;
      Console.WriteLine("Value1 = "+val1);
      Console.WriteLine("Value2 = "+val2);
      Console.WriteLine("HashCode for value1 = "+val1.GetHashCode());
      Console.WriteLine("HashCode for value2 = "+val2.GetHashCode());
      Console.WriteLine("Are they equal? = "+(val1.Equals(val2)));
      TypeCode type1 = val1.GetTypeCode();
      TypeCode type2 = val2.GetTypeCode();
      Console.WriteLine("TypeCode for val1 = "+type1);
      Console.WriteLine("TypeCode for val2 = "+type2);
      Console.WriteLine("Maximum Value = "+ Int32.MaxValue);
      Console.WriteLine("Minimum Value = "+ Int32.MinValue);
   }
}

出力結果

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

Value1 = 23
Value2 = 0
HashCode for value1 = 23
HashCode for value2 = 0
Are they equal? = False
TypeCode for val1 = Int32
TypeCode for val2 = Int32
Maximum Value = 2147483647
Minimum Value = -2147483648

例2：long型からint型への変換時に範囲チェックを行う

Int32.MinValueフィールドは、数値変換の前に範囲チェックを行う場面でも活躍します。次の例では、long型の配列の各要素がInt32の範囲内かどうかを判定し、範囲内であればConvert.ToInt32メソッドを使ってint型に変換しています。

using System;
public class Demo {
   public static void Main(){
      long[]val = {8998, -899898778, 878787878, -20};
      int res;
      foreach(long a in val){
         if(a >= Int32.MinValue && a <= Int32.MaxValue){
            res = Convert.ToInt32(a);
            Console.WriteLine("Converted: "+res);
         }
         else{
            Console.WriteLine("Not Possible");
         }
      }
   }
}

出力結果

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

Converted: 8998
Converted: -899898778
Converted: 878787878
Converted: -20

まとめ

Int32.MinValueフィールドは、Int32型の最小値「-2147483648」を表す便利な定数です。int型の範囲チェックやオーバーフロー防止など、安全な数値処理を実現するために幅広く活用できます。