CKTIS / C#
HashCode.Combine – združevanje vrednosti v zgoščeno kodo
HashCode.Combine ustvari zgoščeno kodo vrste int iz ene do osmih vrednosti. Uporabna je v metodi GetHashCode za tipe z enakostjo, ki temelji na poljih, vendar rezultat ni trajni identifikator in ne dokazuje enakosti.
Različica: .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 je statična metoda tipa System.HashCode, ki je na voljo v .NET 10. Njene preobremenitve sprejmejo od ene do osem vrednosti in vrnejo int. Prikazana sintaksa velja za dve vrednosti; prevajalnik navadno izpelje argumente tipov. Preobremenitev z enim argumentom izboljša porazdelitev zgoščene kode vrednosti.
V implementaciji GetHashCode upoštevajte polja v skladu s pravili metode Equals. Enaki objekti morajo imeti enake zgoščene kode; enake kode pa ne dokazujejo enakosti, saj lahko pride do kolizij. V primeru GridPoint primerja X in Y, HashCode.Combine(X, Y) pa uporabi isti polji v določenem vrstnem redu.
Rezultata ne shranjujte kot trajni identifikator in ga ne primerjajte med zagoni. HashCode uporablja naključno začetno vrednost za proces, njegova implementacija pa se lahko med različicami spremeni. Primer zato izpiše rezultate primerjav namesto številčne zgoščene kode.
Za več kot osem vrednosti uporabite primerek HashCode, zaporedne klice Add in na koncu ToHashCode. Add ima tudi preobremenitev, ki sprejme lasten primerjalnik; uporabna je, kadar mora zgoščevanje ustrezati lastnim pravilom enakosti.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.