CKTIS / C#
HashCode.Combine – kombinování hodnot do hash kódu
HashCode.Combine vytváří hash kód typu int z jedné až osmi hodnot. Hodí se v metodě GetHashCode pro typy s rovností založenou na polích, ale výsledek není trvalý identifikátor ani důkaz rovnosti.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine je statická metoda typu System.HashCode, dostupná v .NET 10. Její přetížení přijímají jednu až osm hodnot a vracejí int. Zobrazená syntaxe se týká dvou hodnot; kompilátor obvykle odvodí argumenty typů. Jednoargumentové přetížení zlepšuje rozložení hash kódu hodnoty.
V implementaci GetHashCode zahrňte pole v souladu s pravidly metody Equals. Shodné objekty musí mít shodné hash kódy; shodné hash kódy ale rovnost nedokazují, protože může dojít ke kolizím. V příkladu GridPoint porovnává X a Y a HashCode.Combine(X, Y) používá tatáž pole v pevném pořadí.
Výsledek neukládejte jako trvalý identifikátor ani ho neporovnávejte mezi spuštěními. HashCode používá náhodné počáteční číslo pro proces a jeho implementace se může mezi verzemi měnit. Příklad proto vypisuje výsledky porovnání, nikoli číselnou hodnotu hash kódu.
Pro více než osm hodnot použijte instanci HashCode, opakovaná volání Add a nakonec ToHashCode. Add má také přetížení, které přijímá vlastní porovnávač; hodí se, když musí hashování odpovídat vlastním pravidlům rovnosti.
Příklady
using System;
var first = new GridPoint(3, 7);
var second = new GridPoint(3, 7);
Console.WriteLine(first.Equals(second));
Console.WriteLine(first.GetHashCode() == second.GetHashCode());
readonly struct GridPoint
{
public GridPoint(int x, int y)
{
X = x;
Y = y;
}
public int X { get; }
public int Y { get; }
public override bool Equals(object? obj) =>
obj is GridPoint other && X == other.X && Y == other.Y;
public override int GetHashCode() => HashCode.Combine(X, Y);
}Výsledek
True True
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.