CKTIS / C#
HashCode.Combine – kombiniranje vrijednosti u hash kod
HashCode.Combine stvara hash kod vrste int na temelju jedne do osam vrijednosti. Koristan je u metodi GetHashCode za tipove čija se jednakost temelji na poljima, ali rezultat nije trajni identifikator ni dokaz jednakosti.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine statička je metoda tipa System.HashCode, dostupna u .NET 10. Njezina preopterećenja prihvaćaju od jedne do osam vrijednosti i vraćaju int. Prikazana sintaksa odnosi se na dvije vrijednosti; prevoditelj obično zaključuje argumente tipa. Preopterećenje s jednim argumentom poboljšava raspodjelu hash koda vrijednosti.
U implementaciji metode GetHashCode uključite polja u skladu s pravilima metode Equals. Jednaki objekti moraju imati jednake hash kodove; jednaki hash kodovi ipak ne dokazuju jednakost jer su moguće kolizije. U primjeru GridPoint uspoređuje X i Y, a HashCode.Combine(X, Y) upotrebljava ista polja fiksnim redoslijedom.
Nemojte spremati rezultat kao trajni identifikator niti ga uspoređivati između pokretanja. HashCode upotrebljava nasumično početno sjeme za proces, a implementacija se može mijenjati između verzija. Zato primjer ispisuje rezultate usporedbi, a ne brojčani hash kod.
Za više od osam vrijednosti upotrijebite instancu HashCode, uzastopne pozive metode Add i na kraju ToHashCode. Add ima i preopterećenje koje prihvaća prilagođeni uspoređivač; korisno je kada hashiranje mora odgovarati prilagođenim pravilima jednakosti.
Primjeri
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);
}Rezultat
True True
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.