C#のUInt64.MaxValueフィールドとは？構文と実装例をわかりやすく解説

C#のUInt64.MaxValueフィールドは、64ビット符号なし整数型（ulong）が表現できる最大値を表します。具体的には「18,446,744,073,709,551,615」という値であり、UInt64型で扱える数値範囲の上限を示す定数として定義されています。

構文

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

public const ulong MaxValue = 18446744073709551615;

例1：UInt64.MaxValueの基本的な使い方

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

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("Maximum Value = "+ UInt64.MaxValue);
    }
}

出力

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

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

例2：値の範囲チェックへの応用

続いて、UInt64.MinValueとUInt64.MaxValueを組み合わせて、値が有効な範囲内に収まっているかどうかを判定する応用例を紹介します。配列内の各値に対して範囲チェックを行い、有効な場合はConvert.ToUInt64メソッドで変換して出力します。

using System;
public class Demo {
    public static void Main(){
        ulong[]val = {8998, 899898778, 878787878};
        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: 8998
Converted: 899898778
Converted: 878787878

このように、UInt64.MaxValueフィールドは値域の検証や境界チェックなど、数値の妥当性を確認したい場面で活用できる便利な定数です。