C#のInt32.MaxValueフィールドとは？使い方とサンプルコードで解説

C#のInt32.MaxValueフィールドは、Int32型（32ビット符号付き整数）が表現できる最大値を表す定数です。その値は2,147,483,647であり、int型の変数に格納できる上限を確認したい場合や、数値変換時に範囲チェックを行いたい場合などに活用できます。

構文

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

public const int MaxValue = 2147483647;

基本的な使用例

まず、Int32.MaxValueフィールドの基本的な使い方を見てみましょう。以下の例では、int型の値のハッシュコードやTypeCodeを確認するとともに、Int32.MaxValueの値を出力しています。

using System;
public class Demo {
   public static void Main(){
      int val1 = 23;
      int val2 = 23;
      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);
   }
}

出力結果

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

Value1 = 23
Value2 = 23
HashCode for value1 = 23
HashCode for value2 = 23
Are they equal? = True
TypeCode for val1 = Int32
TypeCode for val2 = Int32
Maximum Value = 2147483647

実践的な使用例：long型からint型への変換チェック

Int32.MaxValueは、より大きなデータ型からint型へ変換する際の範囲チェックにも役立ちます。次の例では、long型の配列の各要素がInt32.MinValue～Int32.MaxValueの範囲内にあるかどうかを判定し、変換可能な場合のみConvert.ToInt32メソッドで変換しています。

using System;
public class Demo {
   public static void Main(){
      long[]val = {8998, -899898778, 8787867687878, -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
Not Possible
Converted: -20

まとめ

Int32.MaxValueフィールドを使用することで、int型が扱える最大値をハードコーディングせずに安全に参照できます。特に、大きな数値型からの変換処理では、オーバーフローを防ぐための事前チェックとして活用することをおすすめします。同様に、最小値を表すInt32.MinValueフィールドと組み合わせることで、より堅牢な数値処理を実現できます。