C#のUInt32.MinValueフィールドとは？使い方をサンプルコード付きで解説

C#におけるUInt32.MinValueフィールドは、32ビット符号なし整数型（uint）が取り得る最小値を表す定数です。符号なし整数は負の値を持たないため、この最小値は常に「0」となります。

構文（Syntax）

UInt32.MinValueフィールドの構文は以下のとおりです。

public const uint MinValue = 0;

サンプルコード1：UInt32.MinValueの基本的な使い方

まずは、UInt32.MinValueフィールドを実際に使用した基本的な例を見てみましょう。このコードでは、uint型の値に対してハッシュコードの取得、等価性の比較、TypeCodeの確認を行い、最後に最小値を出力しています。

using System;
public class Demo {
   public static void Main(){
      uint val1 = 23;
      uint 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("Minimum Value = "+ UInt32.MinValue);
   }
}

実行結果

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

Value1 = 23
Value2 = 0
HashCode for value1 = 23
HashCode for value2 = 0
Are they equal? = False
TypeCode for val1 = UInt32
TypeCode for val2 = UInt32
Minimum Value = 0

サンプルコード2：範囲チェックへの応用例

続いて、UInt32.MinValueとUInt32.MaxValueを組み合わせて、値がuint型の有効範囲内にあるかどうかを判定する実践的な例を紹介します。ulong型の配列の各要素が、符号なし整数の範囲（0〜4294967295）に収まっているかを確認し、変換可能な場合のみ変換処理を行います。

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

実行結果

このコードを実行すると、すべての値が変換可能であるため、以下の出力が表示されます。

Converted: 8998
Converted: 899898778
Converted: 878787878

まとめ

UInt32.MinValueフィールドは、uint型の下限値である「0」を返す定数です。単体での参照だけでなく、UInt32.MaxValueと組み合わせて値の範囲チェックを行うことで、安全な型変換を実現できます。数値変換処理においてオーバーフローやアンダーフローを防ぎたい場合に非常に役立つフィールドです。