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

C#のUInt64.MinValueフィールドは、64ビット符号なし整数型（ulong）が取り得る最小値を表す定数です。符号なし整数には負の値が存在しないため、このフィールドの値は常に0になります。

本記事では、UInt64.MinValueの構文と、実際のコード例を使った具体的な使い方をわかりやすく解説します。

構文

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

public const ulong MinValue = 0;

const定数として定義されているため、インスタンスを生成せずに「UInt64.MinValue」の形式で直接参照できます。

例1：基本的な使い方

まずは、ulong型の変数に対して各種情報を出力し、最後に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

このように、UInt64.MinValueを参照すると「0」が出力されることが確認できます。

例2：配列の値を範囲チェックして変換する

次に、UInt64.MinValueとUInt64.MaxValueを組み合わせて、値がulong型の有効な範囲内にあるかどうかを判定し、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（上限値：18,446,744,073,709,551,615）と併せて覚えておくとよいでしょう。