C#でUInt64インスタンスのハッシュコード（HashCode）を取得する方法

C#において、現在の UInt64 インスタンスのハッシュコードを取得するには、GetHashCode() メソッドを使用します。このメソッドは、オブジェクトのハッシュコードを表す整数値を返します。

ハッシュコードは、ハッシュテーブルなどのデータ構造でオブジェクトを効率的に管理・検索するために利用される重要な値です。数値型の場合、多くの場面でその値自体がハッシュコードとして返される点も特徴的です。

構文

public override int GetHashCode ();

サンプルコード1

まず、基本的な使用例を見てみましょう。通常の値と UInt64.MinValue のハッシュコードを取得しています。

using System;
public class Demo {
   public static void Main() {
      ulong val1 = 8768768;
      ulong val2 = UInt64.MinValue;
      Console.WriteLine("val1 のハッシュコード = "+val1.GetHashCode());
      Console.WriteLine("val2 のハッシュコード = "+val2.GetHashCode());
   }
}

出力結果

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

val1 のハッシュコード = 8768768
val2 のハッシュコード = 0

この例からわかるように、val1 の場合はその値そのもの（8768768）がハッシュコードとして返されています。また、UInt64.MinValue（最小値である 0）の場合は、ハッシュコードも 0 になります。

サンプルコード2

次に、別の値と UInt64.MaxValue を使った例を見てみましょう。

using System;
public class Demo {
   public static void Main() {
      ulong val1 = 89879878;
      ulong val2 = UInt64.MaxValue;
      Console.WriteLine("val1 のハッシュコード = "+val1.GetHashCode());
      Console.WriteLine("val2 のハッシュコード = "+val2.GetHashCode());
   }
}

出力結果

実行結果は以下の通りです。

val1 のハッシュコード = 89879878
val2 のハッシュコード = 0

ポイント解説

UInt64 型の GetHashCode() メソッドには、以下のような特徴があります。

1. 値がそのまま返される場合がある
数値が int 型の範囲内に収まる場合、その値自体がハッシュコードとして返されます。上記の例でも、8768768 や 89879878 がそのまま出力されています。

2. 戻り値は int 型
GetHashCode() の戻り値は 32 ビットの int 型です。そのため、ulong（64ビット）の大きな値の場合は、ハッシュアルゴリズムによって変換された値が返されます。UInt64.MaxValue のような巨大な値でも、内部的な計算により 0 が出力されるケースがあります。

3. 等しい値は同じハッシュコードを持つ
同じ値を持つ UInt64 インスタンスは、必ず同じハッシュコードを返します。これは Dictionary<TKey, TValue> や HashSet<T> などで正しく動作するために保証されている仕様です。

まとめ

C#で UInt64 インスタンスのハッシュコードを取得するには、GetHashCode() メソッドを呼び出すだけで簡単に実装できます。小さな値では元の値がそのまま返され、大きな値では内部のハッシュ計算によって生成された値が返されることを理解しておくと、デバッグやデータ構造の設計時に役立ちます。