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

C#におけるUInt64.MinValueフィールドは、64ビット符号なし整数（ulong）が表現できる最小値を示す定数です。UInt64型は0〜18,446,744,073,709,551,615までの範囲を持つため、MinValueの値は常に「0」になります。

構文

UInt64.MinValueフィールドの宣言は次のようになっています。

public const ulong MinValue = 0;

使用例1：基本的な値の確認

以下の例では、2つのulong型変数について値、ハッシュコード、等価性、TypeCodeを表示し、最後にUInt64.MinValueの値を出力しています。

using System;
public class Demo {
    public static void Main(){
        ulong val1 = 879879879;
        ulong val2 = 464556565;
        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 = "+ UInt64.MinValue);
    }
}

出力結果

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

Value1 = 879879879
Value2 = 464556565
HashCode for value1 = 879879879
HashCode for value2 = 464556565
Are they equal? = False
TypeCode for val1 = UInt64
TypeCode for val2 = UInt64
Minimum Value = 0

使用例2：範囲チェックでの活用

次の例では、配列内の各値がUInt64.MinValueからUInt64.MaxValueの範囲内にあるかどうかを判定し、範囲内であればConvert.ToUInt64メソッドを使って変換した結果を表示します。

using System;
public class Demo {
    public static void Main(){
        ulong[]val = {65, 6576, 9897987987};
        ulong res;
        foreach(ulong a in val){
            if(a >= UInt64.MinValue && a <= UInt64.MaxValue){
                res = Convert.ToUInt64(a);
                Console.WriteLine("Converted: "+res);
            } else {
                Console.WriteLine("Not Possible");
            }
        }
    }
}

出力結果

実行結果は以下の通りです。すべての値が有効な範囲内にあるため、正常に変換されています。

Converted: 65
Converted: 6576
Converted: 9897987987

まとめ

UInt64.MinValueは、64ビット符号なし整数の下限値「0」を表す定数です。単体でも利用できますが、UInt64.MaxValueと組み合わせることで、値が有効な範囲内に収まっているかどうかのバリデーション処理などを簡潔に記述できます。