CKTIS / C#
HashCode.Combine – kombinovanie hodnôt do hash kódu
HashCode.Combine vytvára hash kód typu int z jednej až ôsmich hodnôt. Hodí sa v metóde GetHashCode pre typy s rovnosťou založenou na poliach, ale výsledok nie je trvalý identifikátor ani dôkaz rovnosti.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine je statická metóda typu System.HashCode, dostupná v .NET 10. Jej preťaženia prijímajú jednu až osem hodnôt a vracajú int. Zobrazená syntax sa týka dvoch hodnôt; kompilátor zvyčajne odvodí argumenty typov. Jednoargumentové preťaženie zlepšuje rozloženie hash kódu hodnoty.
V implementácii GetHashCode zahrňte polia v súlade s pravidlami metódy Equals. Rovnaké objekty musia mať rovnaké hash kódy; rovnaké hash kódy však rovnosť nedokazujú, pretože môžu nastať kolízie. V príklade GridPoint porovnáva X a Y a HashCode.Combine(X, Y) používa tie isté polia v pevnom poradí.
Výsledok neukladajte ako trvalý identifikátor ani ho neporovnávajte medzi spusteniami. HashCode používa náhodné počiatočné číslo pre proces a jeho implementácia sa môže medzi verziami meniť. Príklad preto vypisuje výsledky porovnaní, nie číselnú hodnotu hash kódu.
Pre viac než osem hodnôt použite inštanciu HashCode, opakované volania Add a napokon ToHashCode. Add má aj preťaženie, ktoré prijíma vlastný porovnávač; hodí sa, keď musí hashovanie zodpovedať vlastným pravidlám rovnosti.
Prí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ýsledok
True True
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.